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 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 CocoaPods. CocoaPods adalah dependensi open source untuk proyek Swift dan Objective-C Cocoa.

Jika Anda belum memiliki alat CocoaPods, instal di OS X dengan menjalankan mengikuti perintah dari terminal. Untuk detailnya, lihat dokumentasi CocoaPods Getting Panduan memulai.

$ sudo gem install cocoapods

Langkah 3: Instal API menggunakan CocoaPods

Membuat Podfile untuk Google Nearby Messages API untuk iOS dan menggunakannya untuk menginstal API dan dependensinya.

  • Jika Anda belum memiliki proyek Xcode, buat sekarang dan simpan pada komputer lokal. (Jika Anda baru mengenal pengembangan iOS, buat Single View Aplikasi, dan pastikan bahwa Gunakan Penghitungan Referensi Otomatis diaktifkan.)
  • Buat file bernama Podfile dalam direktori project Anda. File ini menentukan dependensi project-nya.

  • Edit Podfile dan tambahkan dependensi Anda. Berikut ini 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, lalu buka direktori yang berisi Podfile:

    $ cd

  • Jalankan perintah pod install. Ini akan menginstal API yang ditetapkan dalam Podspec, beserta dependensi apa pun yang mungkin dimilikinya.

    $ penginstalan pod

  • 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 bridging header (khusus Swift)

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

  1. Dalam direktori yang sama seperti file .xcworkspace project Anda, tambahkan file baru {i>header<i} (beri nama sesuai keinginan 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 project editor, pilih project utama.
  5. Klik Build Settings di bagian atas editor build.
  6. Di Build Settings, buka "Swift Compiler - Code Generation" (jenis "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 sudah Anda dibuat.
  9. Bangun project agar perubahan diterapkan.

Langkah 5: Buat Akun Google

Untuk menggunakan Nearby Messages API, Anda memerlukan Akun Google. Jika sudah memiliki akun, Anda sudah siap. Anda mungkin juga ingin 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 Konsol Google Developers.
  2. Buat atau pilih project untuk mendaftarkan aplikasi Anda.
  3. Klik Continue untuk Mengaktifkan API.
  4. Di halaman Credentials, buat iOS key baru (dan setel API Kredensial).
    Catatan: Jika 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 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 kami.

Langkah 7: Buat objek pengelola pesan

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

Objective-C

#import <GNSMessages.h>

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

Swift

let messageManager = GNSMessageManager(APIKey: "API_KEY")