Başla

Bu dokümanda, iOS'te Nearby Messages API ile nasıl geliştirmeye başlayabileceğiniz açıklanmaktadır.

1. Adım: En son Xcode sürümünü edinin

iOS için Google Nearby Messages API'sini kullanarak proje oluşturmak için sürüm 6.3 veya daha yeni bir Xcode sürümüne ihtiyacınız vardır.

2. Adım: CocoaPods edinin

iOS için Google Nearby Messages API, CocoaPods kapsülü olarak kullanılabilir. CocoaPods, Swift ve Objective-C Cocoa projelerinde açık kaynak bir bağımlılık yöneticisidir.

Halihazırda CocoaPods aracına sahip değilseniz terminalden aşağıdaki komutu çalıştırarak OS X'e yükleyin. Ayrıntılı bilgi için CocoaPods Başlangıç Kılavuzu'na bakın.

$ sudo gem install cocoapods

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

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

  • Henüz bir Xcode projeniz yoksa hemen bir proje oluşturun ve yerel makinenize kaydedin. (iOS geliştirme konusunda yeniyseniz Tekli Görünüm Uygulaması oluşturun ve Otomatik Referans Sayma Kullanımı'nın açık olduğundan emin olun.)
  • Proje dizininizde Podfile adlı bir dosya oluşturun. Bu dosya projenizin bağımlılıklarını tanımlar.

  • Podfile öğesini düzenleyin ve bağımlılıklarınızı ekleyin. Aşağıda, iOS için Google Nearby Messages API için ihtiyaç duyduğunuz kapsülün adını da içeren basit bir Podspec bulunmaktadır: 

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

  • Podfile dosyasını kaydedin.

  • Bir terminal penceresi açın ve Podfile öğelerini içeren dizine gidin:

    cd

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

    $ kapsül yükleme

  • Xcode'u kapatın ve Xcode'u başlatmak için projenizin .xcworkspace dosyasını açın (çift tıklayın). Bundan sonra, 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 kapsül dosyası tarafından yüklenen kitaplıkları kullanabilmesi için projenize bir köprü başlığı eklemeniz gerekir. Köprü başlığı 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 istediğiniz adı verin ve ".h" dosya adı uzantısı kullanın).
  2. Oluşturduğunuz dosyaya şu kodu yapıştırın: #import <GNSMessages.h>.
  3. Dosyayı kaydedin.
  4. Proje düzenleyicinin sol bölmesindeki ana projeyi seçin.
  5. Derleme düzenleyicisinin üst kısmındaki Derleme Ayarları'nı tıklayın.
  6. Derleme Ayarları'nda "Swift Derleyici - Kod Oluşturma"ya gidin (hızlı bir şekilde bulmak için arama kutusuna "Swift Derleyici" yazın).
  7. Objective-C Köprüleme Başlığı bölümünü genişletmek için oku tıklayın.
  8. Debug (Hata Ayıklama) ve Release (Sürüm) altında, oluşturduğunuz üstbilgi dosyasının yolunu ekleyin.
  9. Değişikliklerin geçerli olması için projeyi oluşturun.

5. Adım: Bir Google hesabı edinin

Nearby Messages API'lerini kullanmak için bir Google Hesabınızın olması gerekir. Zaten bir hesabınız varsa hazırsınız demektir. 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 bir API anahtarı almak için şu adımları uygulayın:

  1. Google Developers Console'a gidin.
  2. Uygulamanızı kaydetmek için 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 tanımlayıcısını girin. Örneğin: 
    com.example.nearbyexample
  6. Yeni iOS API anahtarınız, projenizin API anahtarları listesinde gösterilir. API anahtarı, karakterlerden oluşan bir dizedir. Örnek: 
    AIzaSyBdVl-cTICSwYKrZ95SuvNw7dbMuDt1KG0
  7. Kota hırsızlığını önlemek için bu en iyi uygulamaları izleyerek API anahtarınızı güvence altına alın.

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

Mesaj yöneticisi nesnesi, yayın yapmanıza ve abone olmanıza olanak tanır. Mesaj alışverişinin kimliği doğrulanmamıştır. Bu nedenle, ö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")