Başlarken

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

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

iOS için Google Nearby Messages API'yi kullanarak proje oluşturmak için gerekenler: Xcode'un 6.3 veya sonraki bir sürümüne sahip olmanız gerekir.

2. Adım: CocoaPods edinin

iOS için Google Nearby Messages API'si şu şekilde kullanılabilir: CocoaPods kapsülü. CocoaPods, açık kaynaklı bir bağımlılıktır. yöneticisiyim.

CocoaPods aracınız henüz yüklü değilse aşağıdaki komutu çalıştırarak OS X'e yükleyin: aşağıdaki komutu çalıştırın. Ayrıntılı bilgi için CocoaPods Başlangıç kılavuzu.

$ sudo gem install cocoapods

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

iOS için Google Nearby Messages API'si için bir Podfile oluşturun ve bunu şu amaçlarla kullanın: ve bağımlılıklarını yüklemeniz gerek.

  • Henüz bir Xcode projeniz yoksa şimdi bir tane oluşturun ve yerel makinenizde olması gerekir. (iOS geliştirmede yeniyseniz Tek Görünüm oluşturun Uygulama'yı tıklayın ve Otomatik Referans Sayımı Kullan ayarının açık olduğundan emin olun.)
  • Proje dizininizde Podfile adlı bir dosya oluşturun. Bu dosya, ve projenin bağımlılıklarını konuşacağız.

  • Podfile öğesini düzenleyip bağımlılıklarınızı ekleyin. Burada örnek olarak, Örneğin, Google Nearby Messages API'si için ihtiyacınız olan kapsülün adı iOS: 

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

  • Podfile dosyasını kaydedin.

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

    Cd ABD doları

  • pod install komutunu çalıştırın. Bu işlem, ve olası bağımlılıkları ile birlikte Podspec.

    $ kapsül yüklemesi

  • Xcode'u kapatın ve ardından projenizin .xcworkspace dosyasını açın (çift tıklayın) Xcode'u başlatmak istiyorum. Bu andan itibaren, .xcworkspace dosyasını kullanarak projeyi açın.

4. Adım: Bir köprü başlığı oluşturun (yalnızca Swift)

Projenizi Swift kullanarak oluşturduysanız projesinin Kapsül dosyası tarafından yüklenen kitaplıkları kullanabilmesini sağlar. Köprü üstbilgisi eklemek için şu adımları uygulayın:

  1. Projenizin .xcworkspace dosyasıyla aynı dizinde yeni bir başlık dosyasına istediğiniz adı verin ve ".h" uzantılı bir dosya adı uzantısı kullanın.
  2. Aşağıdaki kodu, oluşturduğunuz dosyaya yapıştırın: #import <GNSMessages.h>
  3. Dosyayı kaydedin.
  4. Proje düzenleyicisinin sol bölmesinden ana projeyi seçin.
  5. Derleme düzenleyicisinin üst kısmındaki Derleme Ayarları'nı tıklayın.
  6. Build Settings'te (Derleme Ayarları) "Swift Compiler - Code Generation"a gidin. (tür: "Swift Compiler" hızlı bir şekilde bulmak için arama kutusuna yazabilirsiniz).
  7. Objective-C Bridging Header (Objective-C Köprüleme Başlığı) bölümünü genişletmek için oku tıklayın.
  8. Hata Ayıkla ve Sürüm'ün altında, yüklediğiniz başlık dosyasının yolunu oluşturuldu.
  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 Google Hesabınızın olması gerekir. Halihazırda bir hesabınız varsa hazırsınız demektir. Ayrıca şunları da isteyebilirsiniz: test amacıyla ayrı bir Google Hesabı oluşturabilirsiniz.

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

iOS için Google Nearby Messages API'yi etkinleştirmek ve API anahtarı:

  1. gidin. Google Developers Console'da oturum açın.
  2. Uygulamanızın kaydedileceği 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'yi Kimlik bilgileri).
    . Not: Mevcut bir iOS anahtarınız varsa bu anahtarı kullanabilirsiniz.
  5. Açılan iletişim kutusunda, 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örünür. API anahtarı, aşağıdaki gibi bir karakter dizesidir: 
    AIzaSyBdVl-cTICSwYKrZ95SuvNw7dbMuDt1KG0
    .
  7. Kota hırsızlığını önlemek için aşağıdaki adımları uygulayarak API anahtarınızın güvenliğini sağlayın en iyi uygulamalara göz atın.
ziyaret edin.

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

Mesaj yöneticisi nesnesi, mesaj yayınlamanızı ve abone olmanızı sağlar. Mesaj alışverişi (şimdiki değeri) kimlik doğrulamasız olduğundan önceki adımına geçelim.

Objective-C

#import <GNSMessages.h>

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

Swift

let messageManager = GNSMessageManager(APIKey: "API_KEY")