Başlarken

Bu belgede, iOS'te Nearby Messages API ile 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 Nearby Messages API'yi kullanarak bir proje oluşturmak istiyorsanız Xcode'un 6.3 veya sonraki bir sürümünü kullanmanız gerekir.

2. adım: CocoaPods'u edinin

iOS için Google Nearby Messages API, CocoaPods pod'u olarak kullanılabilir. CocoaPods, Swift ve Objective-C Cocoa projeleri için açık kaynaklı bir bağımlılık yöneticisidir.

CocoaPods aracınız yoksa terminalden aşağıdaki komutu çalıştırarak OS X'e yükleyin. Ayrıntılar için CocoaPods'u kullanmaya başlama kılavuzu'na bakın.

$ sudo gem install cocoapods

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

iOS için Google Nearby Messages API'si için bir Podfile oluşturun ve API'yi ve bağımlılıklarını yüklemek için kullanın.

  • Henüz bir Xcode projeniz yoksa hemen bir proje oluşturup yerel makinenize kaydedin. (iOS geliştirmeye yeni başladıysanız Single View Application oluşturun ve Use Automatic Reference Counting'in etkin olduğundan 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ınızı ekleyin. iOS için Google Nearby Messages API'si için ihtiyacınız olan pod'un 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 öğesini kaydedin.

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

    $ cd

  • pod install komutunu çalıştırın. Bu komut, Podspec'te belirtilen API'leri ve sahip olabilecekleri bağımlılıkları 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 andan itibaren projeyi açmak için .xcworkspace dosyasını kullanmanız gerekir.

4. adım: Köprüleme 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. Köprü üstbilgisi eklemek için aşağıdaki adımları uygulayın:

  1. Projenizin .xcworkspace dosyasıyla aynı dizine yeni bir başlık dosyası ekleyin (dilediğiniz adı verin ve ".h" dosya adı uzantısını kullanın).
  2. Aşağıdaki kodu oluşturduğunuz dosyaya yapıştırın: #import <GNSMessages.h>.
  3. Dosyayı kaydedin.
  4. Proje düzenleyicinin sol bölmesinde ana projeyi seçin.
  5. Derleme düzenleyicisinin üst kısmındaki Build Settings'i (Derleme Ayarları) tıklayın.
  6. Derleme Ayarları'nda "Swift Compiler - Code Generation"a gidin (hızlıca bulmak için arama kutusuna "Swift Compiler" yazın).
  7. Objective-C Bridging Header bölümünü genişletmek için oku tıklayın.
  8. Debug (Hata Ayıklama) ve Release (Yayın) altında, oluşturduğunuz başlık dosyasının yolunu ekleyin.
  9. Değişikliklerin geçerli olması için projeyi oluşturun.

5. adım: Google Hesabı edinin

Nearby Messages API'lerini kullanmak için Google Hesabınızın olması gerekir. Hesabınız varsa başka bir şey yapmanız gerekmez. Test amacıyla ayrı bir Google Hesabı da kullanmak isteyebilirsiniz.

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

iOS için Google Nearby Messages API'yi etkinleştirmek ve API anahtarı almak üzere şu adımları uygulayın:

  1. Google Developers Console'a gidin.
  2. Uygulamanızı kaydettireceğ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ı, şu gibi bir karakter dizisidir: 
    AIzaSyBdVl-cTICSwYKrZ95SuvNw7dbMuDt1KG0
  7. Kota hırsızlığını önlemek için API anahtarınızı aşağıdaki en iyi uygulamalara uygun şekilde güvenli hâle getirin.

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

İleti yöneticisi nesnesi, yayınlamanıza ve abone olmanıza olanak tanır. Mesaj alışverişi kimliği doğrulanmamış olduğundan önceki adımda oluşturduğunuz API anahtarını sağlamanız gerekir.

Objective-C

#import <GNSMessages.h>

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

Swift

let messageManager = GNSMessageManager(APIKey: "API_KEY")