Mulai

Dokumen ini menjelaskan cara mulai mengembangkan dengan Nearby Messages API di iOS.

Langkah 1: Dapatkan Xcode versi terbaru

Untuk mem-build project menggunakan Google Nearby Messages API for iOS, Anda memerlukan Xcode versi 6.3 atau yang lebih baru.

Langkah 2: Dapatkan CocoaPods

Google Nearby Messages API untuk iOS tersedia sebagai pod CocoaPods. CocoaPods adalah pengelola dependensi open source untuk project Swift dan Objective-C Cocoa.

Jika Anda belum memiliki alat CocoaPods, instal di OS X dengan menjalankan perintah berikut dari terminal. Untuk mengetahui detailnya, lihat Panduan Memulai CocoaPods.

$ sudo gem install cocoapods

Langkah 3: Instal API menggunakan CocoaPods

Buat Podfile untuk Google Nearby Messages API untuk iOS dan gunakan untuk menginstal API beserta dependensinya.

  • Jika Anda belum memiliki project Xcode, buat sekarang dan simpan ke komputer lokal Anda. (Jika Anda baru mengenal pengembangan iOS, buat Aplikasi Tampilan Tunggal, dan pastikan Use Automatic Reference Counting diaktifkan.)
  • Buat file bernama Podfile dalam direktori project Anda. File ini menentukan dependensi project Anda.

  • Edit Podfile dan tambahkan dependensi Anda. Berikut adalah Podspec sederhana, termasuk nama pod yang Anda perlukan untuk Google Nearby Messages API untuk iOS: 

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

  • Simpan Podfile.

  • Buka terminal dan buka direktori yang berisi Podfile:

    $ cd

  • Jalankan perintah pod install. Tindakan ini akan menginstal API yang ditentukan di Podspec, beserta dependensi yang mungkin dimiliki.

    $ pod install

  • Tutup Xcode, lalu buka (klik dua kali) file .xcworkspace project Anda untuk meluncurkan Xcode. Mulai saat ini dan seterusnya, Anda harus menggunakan file .xcworkspace untuk membuka project.

Langkah 4: Buat header jembatan (khusus Swift)

Jika membuat project menggunakan Swift, Anda harus menambahkan header jembatan ke project agar dapat menggunakan library yang diinstal oleh file pod. Lakukan langkah-langkah berikut untuk menambahkan header jembatan:

  1. Di direktori yang sama dengan file .xcworkspace project Anda, tambahkan file header baru (beri nama apa pun yang Anda inginkan dan gunakan ekstensi nama file ".h").
  2. Tempel kode berikut ke dalam file yang Anda buat: #import <GNSMessages.h>.
  3. Simpan file.
  4. Di panel kiri editor project, pilih project utama.
  5. Klik Build Settings di bagian atas editor build.
  6. Di Setelan Build, buka "Swift Compiler - Code Generation" (ketik "Swift Compiler" ke kotak penelusuran untuk menemukannya dengan cepat).
  7. Klik panah untuk meluaskan bagian Objective-C Bridging Header.
  8. Di bagian Debug dan Release, tambahkan jalur ke file header yang Anda buat.
  9. Build project agar perubahan diterapkan.

Langkah 5: Dapatkan Akun Google

Untuk menggunakan Nearby Messages API, Anda memerlukan Akun Google. Jika sudah memiliki akun, Anda sudah siap. Sebaiknya buat Akun Google terpisah untuk tujuan pengujian.

Langkah 6: Mendapatkan kunci API

Lakukan langkah-langkah berikut untuk mengaktifkan Google Nearby Messages API untuk iOS dan mendapatkan kunci API:

  1. Buka Google Developers Console.
  2. Buat atau pilih project untuk mendaftarkan aplikasi Anda.
  3. Klik Continue untuk Mengaktifkan API.
  4. Di halaman Credentials, buat kunci iOS baru (dan tetapkan Kredensial API).
    Catatan: Jika Anda sudah memiliki kunci iOS, Anda dapat menggunakan kunci tersebut.
  5. Dalam dialog yang muncul, masukkan ID paket aplikasi Anda. Contoh: 
    com.example.nearbyexample
  6. Kunci API iOS baru akan muncul dalam daftar kunci API untuk project Anda. Kunci API adalah string karakter, seperti ini: 
    AIzaSyBdVl-cTICSwYKrZ95SuvNw7dbMuDt1KG0
  7. Untuk mencegah pencurian kuota, amankan kunci API Anda dengan mengikuti praktik terbaik berikut.

Langkah 7: Buat objek pengelola pesan

Objek pengelola pesan memungkinkan Anda memublikasikan dan berlangganan. Pertukaran pesan tidak diautentikasi, jadi Anda harus memberikan kunci API yang dibuat di langkah sebelumnya.

Objective-CSwift

#import <GNSMessages.h>

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


let messageManager = GNSMessageManager(APIKey: "API_KEY")