Başlayın

Bu dokümanda, iOS'te Yakındaki Mesajlar API'sini kullanarak geliştirmeye nasıl başlayacağınız açıklanmaktadır.

1. Adım: Xcode'un en son sürümünü edinin

iOS için Google Yakındaki Mesajlar API'sini kullanarak proje oluşturmak istiyorsanız Xcode'un 6.3 sürümünü veya daha yeni bir sürümünü kullanmanız gerekir.

2. Adım: CocoaPods'u edinin

iOS için Google Yakındaki Mesajlar API'si, CocoaPods kapsülü olarak kullanılabilir. CocoaPods, Swift ve Objective-C Cocoa projeleri için açık kaynak bir bağımlılık yöneticisidir.

CocoaPods aracı yüklü değilse terminalde aşağıdaki komutu çalıştırarak OS X'e yükleyin. Ayrıntılar için CocoaPods Başlangıç Kılavuzu'na bakın.

$ sudo gem install cocoapods

3. Adım: CocoaPods'u kullanarak API'yi yükleyin

iOS için Google Yakındaki Mesajlar API'si için bir Podfile oluşturun ve API'yi ve bağımlılarını yüklemek için kullanın.

  • Henüz bir Xcode projeniz yoksa hemen bir proje oluşturun ve yerel makinenize kaydedin. (iOS geliştirmeye yeni başladıysanız tek görünümlü bir uygulama oluşturun ve Otomatik Referans Sayımı'nı Kullan'ın etkinleştirildiğinden emin olun.)
  • Proje dizininizde Podfile adlı bir dosya oluşturun. Bu dosya, projenizin bağımlılıklarını tanımlar.

  • Podfile dosyasını düzenleyin ve bağımlılıkları ekleyin. iOS için Google Yakındaki Mesajlar API'si için ihtiyacınız olan kapsülün adını içeren basit bir Podspec aşağıda verilmiştir: 

    source 'https://github.com/CocoaPods/Specs.git'
platform :ios, '7.0'
pod 'NearbyMessages'

  • Podfile dosyasını kaydedin.

  • Bir terminal açıp Podfile dosyasını içeren dizine gidin:

    $ cd

  • pod install komutunu çalıştırın. Bu işlem, Podspec'te belirtilen API'leri ve sahip olabilecekleri tüm bağımlılıklarını yükler.

    $ pod install

  • Xcode'u kapatın ve ardından Xcode'u başlatmak için projenizin .xcworkspace dosyasını açın (çift tıklayın). Bu tarihten itibaren projeyi açmak için .xcworkspace dosyasını kullanmanız gerekir.

4. adım: Köprü başlığı oluşturun (yalnızca Swift)

Projenizi Swift kullanarak oluşturduysanız pod dosyası tarafından yüklenen kitaplıkları kullanabilmesi için projenize bir köprü başlığı eklemeniz gerekir. Geçiş üstbilgisi eklemek için aşağıdaki adımları uygulayın:

  1. Projenizin .xcworkspace dosyasıyla aynı dizinde yeni bir başlık dosyası ekleyin (dosyaya dilediğiniz adı verin ve ".h" dosya uzantısını kullanın).
  2. Oluşturduğunuz dosyaya aşağıdaki kodu yapıştırın: #import <GNSMessages.h>.
  3. Dosyayı kaydedin.
  4. Proje düzenleyicinin sol bölmesinde ana projeyi seçin.
  5. Derleme düzenleyicinin üst kısmındaki Derleme Ayarları'nı tıklayın.
  6. Derleme ayarlarında "Swift Derleyici - Kod Oluşturma"ya gidin (hızlıca bulmak için arama kutusuna "Swift Derleyici" yazın).
  7. Objective-C Köprü Başlığı bölümünü genişletmek için oku tıklayın.
  8. Hata ayıklama ve Sürüm bölümünün altına, oluşturduğunuz başlık dosyasının yolunu ekleyin.
  9. Değişikliklerin geçerli olması için projeyi derleyin.

5. Adım: Google Hesabı alın

Yakındakilerle Mesajlaşma API'lerini kullanmak için bir Google Hesabınız olmalıdır. Zaten bir hesabınız varsa hazırsınız demektir. Test amacıyla ayrı bir Google Hesabı da kullanabilirsiniz.

6. Adım: API anahtarı alın

iOS için Google Yakındaki Mesajlar API'yi etkinleştirmek ve API anahtarı almak üzere aşağıdaki adımları uygulayın:

  1. Google Developers Console'a gidin.
  2. Uygulamanızı kaydedeceğiniz bir proje oluşturun veya seçin.
  3. API'yi etkinleştirmek için Devam'ı tıklayın.
  4. Kimlik bilgileri sayfasında yeni bir iOS anahtarı oluşturun (ve API kimlik bilgilerini ayarlayın).
    Not: Mevcut bir iOS anahtarınız varsa bu anahtarı kullanabilirsiniz.
  5. Açılan iletişim kutusuna uygulamanızın paket kimliğini girin. Örneğin: 
    com.example.nearbyexample
  6. Yeni iOS API anahtarınız, projenizin API anahtarları listesinde görünür. API anahtarı, şuna benzer bir karakter dizisidir: 
    AIzaSyBdVl-cTICSwYKrZ95SuvNw7dbMuDt1KG0
  7. Kota hırsızlığını önlemek için API anahtarınızı aşağıdaki en iyi uygulamalardan yararlanarak güvence altına alın.

7. adım: Mesaj yöneticisi nesnesi oluşturun

Mesaj yöneticisi nesnesi, yayınlamanıza ve abone olmanıza olanak tanır. Mesaj alışverişinde kimlik doğrulaması yapılmaz. Bu nedenle, önceki adımda oluşturduğunuz API anahtarını sağlamanız gerekir.

Objective-CSwift

#import <GNSMessages.h>

GNSMessageManager *messageManager =
    [[GNSMessageManager alloc] initWithAPIKey:@"API_KEY"];


let messageManager = GNSMessageManager(APIKey: "API_KEY")