Mulai

Dokumen ini menjelaskan cara memulai pengembangan dengan Nearby Messages API di iOS.

Langkah 1: Dapatkan Xcode versi terbaru

Untuk membuat project menggunakan Google Nearby Messages API untuk iOS, Anda memerlukan versi 6.3 atau yang lebih baru dari Xcode.

Langkah 2: Mendapatkan 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 serta dependensinya.

  • Jika Anda belum memiliki project Xcode, buat sekarang dan simpan ke mesin lokal Anda. (Jika Anda baru mengenal pengembangan iOS, buat Satu Aplikasi Tampilan, dan pastikan opsi Gunakan Penghitungan Referensi Otomatis diaktifkan.)
  • Buat file bernama Podfile dalam direktori project Anda. File ini mendefinisikan dependensi project Anda.

  • Edit Podfile dan tambahkan dependensi Anda. Berikut adalah Podspec sederhana, termasuk nama pod yang diperlukan 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 dalam Podspec, beserta dependensi yang mungkin dimiliki.

    $ penginstalan pod

  • Tutup Xcode, lalu buka (klik dua kali) file .xcworkspace project Anda untuk meluncurkan Xcode. Untuk selanjutnya, Anda harus menggunakan file .xcworkspace untuk membuka project.

Langkah 4: Buat header penghubung (khusus Swift)

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

  1. Dalam direktori yang sama dengan file .xcworkspace project Anda, tambahkan file header baru (beri nama sesuka Anda dan gunakan ekstensi nama file ".h").
  2. Tempel kode berikut ke 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 Build Settings, buka "Swift Compiler - Code Generation" (ketik "Swift Compiler" ke kotak penelusuran untuk menemukannya dengan cepat).
  7. Klik tanda panah untuk meluaskan bagian Objective-C Bridging Header.
  8. Di bagian Debug dan Release, tambahkan jalur ke file header yang Anda buat.
  9. Buat project agar perubahan dapat diterapkan.

Langkah 5: Dapatkan Akun Google

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

Langkah 6: Mendapatkan kunci API

Lakukan langkah-langkah berikut untuk mengaktifkan Google Nearby Messages API for 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. Pada halaman Credentials, buat iOS key baru (dan tetapkan Credentials API).
    Catatan: Jika Anda sudah memiliki kunci iOS, Anda dapat menggunakan kunci tersebut.
  5. Pada dialog yang muncul, masukkan ID paket aplikasi Anda. Contoh: 
    com.example.nearbyexample
  6. Kunci API iOS baru Anda akan muncul dalam daftar kunci API untuk project. Kunci API adalah string karakter, seperti ini: 
    AIzaSyBdVl-cTICSwYKrZ95SuvNw7dbMuDt1KG0
  7. Untuk mencegah pencurian kuota, amankan kunci API Anda dengan mengikuti praktik terbaik ini.

Langkah 7: Buat objek pengelola pesan

Objek pengelola pesan memungkinkan Anda memublikasikan dan berlangganan. Pertukaran pesan tidak diautentikasi, jadi Anda harus menyediakan kunci API yang Anda buat pada langkah sebelumnya.

Objective-C

#import <GNSMessages.h>

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

Swift

let messageManager = GNSMessageManager(APIKey: "API_KEY")