Mulai

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

Langkah 1: Dapatkan Xcode versi terbaru

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

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 for iOS dan gunakan untuk menginstal API dan dependensinya.

  • Jika Anda belum memiliki project Xcode, buatlah sekarang dan simpan ke komputer lokal Anda. (Jika Anda baru mengenal pengembangan iOS, buat Single View Application, 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 butuhkan 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 pilih direktori yang berisi Podfile:

    $ cd

  • Jalankan perintah pod install. Tindakan ini akan menginstal API yang ditentukan dalam 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 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. Di direktori yang sama dengan file .xcworkspace project Anda, tambahkan file header baru (beri nama sesuai keinginan 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 Setelan Build di bagian atas editor build.
  6. Di Setelan Build, buka "Swift Compiler - Code Generation" (ketik "Swift Compiler" di kotak penelusuran untuk menemukannya dengan cepat).
  7. Klik panah untuk meluaskan bagian Objective-C Bridging Header.
  8. Di bagian Debug dan Rilis, tambahkan jalur ke file header yang Anda buat.
  9. Bangun project untuk menerapkan perubahan.

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 memiliki kunci iOS yang sudah ada, Anda dapat menggunakan kunci tersebut.
  5. Di 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 Anda. 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 memberikan 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")