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 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 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ınızı ekleyin. iOS için Google Nearby Messages API'si için ihtiyacınız olan pod'un adını da 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 dosyasını içeren dizine gidin:

    $ cd

  • pod install komutunu çalıştırın. Bu işlem, Podspec'te belirtilen API'leri ve varsa 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 andan 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. 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ı verebilir ve ".h" dosya adı uzantısını kullanabilirsiniz).
  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üzenleyicinin üst kısmındaki Derleme Ayarları'nı 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ıza gerek yoktur. Test amacıyla ayrı bir Google Hesabı da isteyebilirsiniz.

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

iOS için Google Nearby Messages API'yi etkinleştirmek ve API anahtarı almak için ş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 aşağıdaki en iyi uygulamaları izleyerek API anahtarınızı 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")