Menyiapkan project Xcode

Setelah mengaktifkan penagihan dan membuat kunci API, Anda siap menyiapkan project Xcode yang Anda gunakan untuk mengembangkan aplikasi Anda.

Catatan rilis tersedia untuk setiap rilis.

Langkah 1: Instal software yang diperlukan

Untuk membuat project menggunakan Places SDK for iOS, Anda memerlukan:

• Xcode versi 16.0 atau yang lebih baru

Langkah 2: Buat project Xcode dan instal Places SDK for iOS

Swift Package Manager

Places SDK for iOS dapat diinstal melalui Swift Package Manager. Untuk menambahkan SDK, pastikan Anda telah menghapus semua dependensi Places SDK for iOS yang ada.

Penting: Petunjuk ini mengasumsikan penggunaan Xcode 15 atau yang lebih baru, tetapi harus serupa untuk Xcode versi sebelumnya.

Untuk menambahkan SDK ke project baru atau yang sudah ada, ikuti langkah-langkah berikut:

1. Buka project atau workspace Xcode Anda, lalu buka File > Add Package Dependencies.
2. Masukkan https://github.com/googlemaps/ios-places-sdk sebagai URL, tekan Enter untuk menarik paket, lalu klik "Add Package".
3. Untuk menginstal version tertentu, tetapkan kolom Aturan Dependensi ke salah satu opsi berbasis versi. Untuk project baru, sebaiknya tentukan versi terbaru dan gunakan opsi "Versi Persis". Setelah selesai, klik "Tambahkan Paket".
4. Dari jendela Choose Package Products, verifikasi bahwa GooglePlaces, GooglePlacesSwift, atau keduanya, akan ditambahkan ke target utama yang ditentukan. Setelah selesai, klik Tambahkan Paket.

   Jika Anda mengupdate Google Places Swift dari URL GitHub yang tidak digunakan lagi

   Penting: URL GitHub untuk mengakses Google Places Swift telah berubah mulai dari versi 0.3.0. Jika Anda mengupdate versi GooglePlacesSwift yang diakses melalui URL lama, https://github.com/googlemaps/ios-places-swift-sdk, hapus dari bagian dependensi paket Xcode Anda.

5. Untuk memverifikasi penginstalan, buka panel Umum target Anda. Di Frameworks, Libraries, and Embedded Content, Anda akan melihat paket yang diinstal. Anda juga dapat melihat bagian Package Dependencies di Project Navigator untuk memverifikasi paket dan versinya.

Untuk memperbarui package project yang ada, ikuti langkah-langkah berikut:

1. Dari Xcode, buka "File > Packages > Update To Latest Package Versions".

   Jika Anda mengupdate Google Places Swift dari URL GitHub yang tidak digunakan lagi

   Penting: URL GitHub untuk mengakses Google Places Swift telah berubah mulai dari versi 0.3.0. Jika Anda mengupdate versi GooglePlacesSwift yang diakses melalui URL lama, https://github.com/googlemaps/ios-places-swift-sdk, hapus dari bagian dependensi paket Xcode Anda.

2. Untuk memverifikasi penginstalan, buka bagian Package Dependencies di Project Navigator untuk memverifikasi paket dan versinya.

Penting: Terkadang, artefak tidak dapat diselesaikan atau terjadi error, dalam hal ini, pilih "File > Packages > Reset Package Cache".

Untuk menghapus Places SDK for iOS yang sudah ada dan diinstal secara manual, ikuti langkah-langkah berikut:

1. Dari setelan konfigurasi project Xcode, temukan Frameworks, Libraries, and Embedded Content. Gunakan tanda minus(-) untuk menghapus framework berikut:
   • GooglePlaces.xcframework
   • GooglePlacesSwift.xcframework
2. Dari direktori level teratas project Xcode, hapus paket GooglePlaces.

Penginstalan manual

Panduan ini menunjukkan cara menambahkan XCFramework yang berisi Places SDK for iOS dan Places Swift SDK for iOS secara manual ke project Anda dan mengonfigurasi setelan build di Xcode. XCFramework adalah paket biner yang dapat Anda gunakan di beberapa platform, termasuk mesin yang menggunakan Apple silicon. Anda dapat memilih untuk menambahkan Places SDK for iOS, Places Swift SDK for iOS, atau keduanya.

1. Download file biner dan resource SDK berikut:
   • GooglePlaces
   • GooglePlacesResources
2. Jika Anda menginstal Places Swift SDK for iOS, instal file berikut:
   • GooglePlacesSwift
   • GooglePlacesSwiftResources
3. Ekstrak file untuk mengakses XCFramework dan resource.
4. Luncurkan Xcode dan buka project yang ada, atau buat project baru. Jika Anda masih awam dengan pengembangan iOS, buat project baru dan pilih iOS App template.
5. Buang semua bundel Maps rilis sebelumnya dari proyek Anda.
6. Buka tab Umum. Tarik XCFramework berikut ke project Anda di bagian Frameworks, Libraries, and Embedded Content. Pastikan untuk memilih Jangan Sematkan:
   • GooglePlaces.xcframework
   Jika Anda menginstal Places Swift SDK, tarik XCFramework berikut ke project Anda di bagian Frameworks, Libraries, and Embedded Content. Pastikan untuk memilih Jangan Sematkan:
   • GooglePlacesSwift.xcframework
7. Salin GooglePlaces.bundle dari GooglePlacesResources yang Anda download ke direktori level teratas project Xcode Anda. Pastikan untuk memilih Copy items into destination group's folder saat diminta.
   
   Jika Anda menginstal Places Swift SDK, salin GooglePlacesSwift.bundle dari GooglePlacesSwiftResources yang Anda download ke direktori tingkat teratas project Xcode Anda. Pastikan untuk memilih Copy items into destination group's folder saat diminta.
8. Pilih project Anda dari Project Navigator, lalu pilih target aplikasi Anda.
9. Buka tab Build Phases. Dalam Link Binary with Libraries, tambahkan framework dan library berikut:
   • CoreGraphics.framework
   • CoreLocation.framework
   • libc++.tbd
   • libz.tbd
   • QuartzCore.framework
   • UIKit.framework

10. Pilih project Anda, bukan target tertentu, dan buka tab Build Settings. Di bagian Linking - General -> Other Linker Flags, tambahkan -ObjC ke "Debug" dan "Release". Jika setelan ini tidak terlihat, ubah filter di bar Build Settings dari Basic ke All.

CocoaPods

Places SDK for iOS dan Places Swift SDK for iOS tersedia sebagai pod CocoaPod, GooglePlaces dan GooglePlacesSwift.

CocoaPods merupakan pengelola dependensi open source untuk proyek Swift dan Objective-C Cocoa. Jika Anda belum memiliki alat CocoaPods, instal di macOS dengan menjalankan perintah berikut dari terminal. Untuk mengetahui detailnya, lihat Panduan Memulai CocoaPods.

sudo gem install cocoapods

Buat Podfile untuk menginstal SDK dan dependensinya:

1. Jika Anda belum memiliki project Xcode, buatlah sekarang dan simpan ke komputer lokal Anda. Jika Anda masih awam dengan pengembangan iOS, buat project baru lalu pilih iOS App template.
2. Buat file bernama Podfile dalam direktori project Anda. File ini mendefinisikan dependensi project Anda.
3. Edit Podfile dan tambahkan dependensi Anda beserta versinya. Berikut adalah contoh yang menentukan nama target aplikasi Anda, dan nama pod GooglePlaces dan GooglePlacesSwift:

   source 'https://github.com/CocoaPods/Specs.git'
   
   platform :ios, '16.0'
   
   target 'YOUR_APPLICATION_TARGET_NAME_HERE' do
     pod 'GooglePlaces', '10.1.0'
     pod 'GooglePlacesSwift', '10.1.0'
   end

   Pastikan untuk menjalankan pod outdated secara rutin untuk mendeteksi kapan ada versi yang lebih baru agar Anda selalu menggunakan versi terbaru.
4. Simpan Podfile.

5. Buka terminal dan pilih direktori yang berisi Podfile:

   cd <path-to-project>

6. Jalankan perintah pod install. Ini akan menginstal API yang ditentukan di Podfile, beserta dependensi yang mungkin dimiliki.

   pod install

7. 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.

Untuk mengupdate API project yang ada, ikuti langkah-langkah berikut:

1. Buka terminal, lalu buka direktori project yang berisi Podfile.
2. Jalankan perintah pod update. Tindakan ini akan mengupdate semua API yang ditentukan dalam Podfile ke versi terbaru.

Langkah 3: Tambahkan kunci API ke aplikasi Anda

Pada contoh berikut, ganti YOUR_API_KEY dengan kunci API Anda.

GooglePlacesSwift

Tambahkan kunci API ke AppDelegate.swift sebagai berikut:

• Tambahkan pernyataan import berikut:

  import GooglePlacesSwift

• Tambahkan hal berikut ke metode application(_:didFinishLaunchingWithOptions:) Anda, yang menggantikan YOUR_API_KEY dengan kunci API Anda:

  PlacesClient.provideAPIKey("YOUR_API_KEY")

Swift

Tambahkan kunci API ke AppDelegate.swift sebagai berikut:

• Tambahkan pernyataan import berikut:

  import GooglePlaces

• Tambahkan hal berikut ke metode application(_:didFinishLaunchingWithOptions:) Anda, yang menggantikan YOUR_API_KEY dengan kunci API Anda:

  GMSPlacesClient.provideAPIKey("YOUR_API_KEY")

Objective-C

Tambahkan kunci API ke AppDelegate.m sebagai berikut:

• Tambahkan pernyataan import berikut:

  @import GooglePlaces;

• Tambahkan hal berikut ke metode application:didFinishLaunchingWithOptions: Anda, yang menggantikan YOUR_API_KEY dengan kunci API Anda:

  [GMSPlacesClient provideAPIKey:@"YOUR_API_KEY"];

Langkah 4 (opsional): Periksa file Manifes Privasi Apple

Catatan: Berikut ini relevan saat Anda men-deploy aplikasi ke web store.

Apple mewajibkan detail privasi aplikasi untuk aplikasi di App Store. Buka halaman Detail Privasi Apple App Store untuk mengetahui info terbaru dan informasi selengkapnya.

File Manifes Privasi Apple disertakan dalam paket resource untuk SDK. Untuk memverifikasi bahwa File Manifes Privasi telah disertakan, dan untuk memeriksa isinya, buat arsip aplikasi Anda dan buat laporan privasi dari arsip tersebut.

Langkah berikutnya

• Mulai menulis kode. Titik awal yang direkomendasikan adalah menerapkan aplikasi starter yang mendapatkan tempat pengguna saat ini.
• Setelah project dikonfigurasi, Anda dapat menjelajahi aplikasi contoh.
• Gunakan App Check untuk mengamankan kunci API Anda.