Menyiapkan project Xcode

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

Catatan rilis tersedia untuk setiap rilis.

Langkah 1: Instal software yang diperlukan

Untuk mem-build project menggunakan Maps SDK for iOS, Anda harus mendownload dan menginstal:

• Xcode versi 15.0 atau yang lebih baru

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

Catatan: Maps SDK for iOS menambahkan ukuran IPA rata-rata 5,7 MB untuk aplikasi yang dibuat untuk perangkat tertentu. Ukuran download untuk aplikasi universal mungkin lebih besar.

Ukuran penginstalan SDK dapat bervariasi. Misalnya, ukuran penginstalan untuk Maps SDK for iOS versi 9.0 adalah sekitar 18 MB.

Catatan: Dengan versi 9.2.0, GoogleMapsCore dan GoogleMapsBase digabungkan ke dalam GoogleMaps XCFramework. Tidak diperlukan penyiapan tambahan.

Swift Package Manager

Maps SDK for iOS dapat diinstal melalui Swift Package Manager. Untuk menambahkan SDK, pastikan Anda telah menghapus dependensi Maps 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 Xcode project atau workspace, lalu buka File > Add Package Dependencies.
2. Masukkan https://github.com/googlemaps/ios-maps-sdk sebagai URL, tekan Enter untuk mengambil paket, lalu klik "Add Package".
3. Untuk menginstal version tertentu, tetapkan kolom Dependency Rule ke salah satu opsi berbasis versi. Untuk project baru, sebaiknya tentukan versi terbaru dan gunakan opsi "Versi Persis". Setelah selesai, klik "Tambahkan Paket".

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

1. Jika mengupgrade dari versi yang lebih lama dari 9.0.0, Anda harus menghapus dependensi berikut: GoogleMapsBase, GoogleMapsCore, dan GoogleMapsM4B setelah mengupgrade. Jangan hapus dependensi untuk GoogleMaps. Untuk informasi selengkapnya, lihat Catatan Rilis Versi 9.0.0.

   Dari setelan konfigurasi project Xcode, temukan Framework, Library, dan Embedded Content. Gunakan tanda minus(-) untuk menghapus framework berikut:

   • GoogleMapsBase (Hanya untuk upgrade dari versi yang lebih lama dari 9.0.0)
   • GoogleMapsCore (Hanya untuk upgrade dari versi yang lebih lama dari 9.0.0)
   • GoogleMapsM4B (Hanya untuk upgrade dari versi yang lebih lama dari 9.0.0)
2. Dari Xcode, buka "File > Packages > Update To Latest Package Versions".
3. Untuk memverifikasi penginstalan, buka bagian Package Dependencies di Project Navigator untuk memverifikasi paket dan versinya.

Penting: Terkadang, artefak tidak dapat di-resolve atau error dapat terjadi. Dalam hal ini, pilih "File > Packages > Reset Package Cache".

Untuk menghapus dependensi Maps SDK for iOS yang ada yang ditambahkan menggunakan CocoaPods, ikuti langkah-langkah berikut:

1. Tutup ruang kerja Xcode Anda. Buka terminal dan jalankan perintah berikut:

   sudo gem install cocoapods-deintegrate cocoapods-clean 
   pod deintegrate 
   pod cache clean --all

2. Hapus Podfile, Podfile.resolved, dan workspace Xcode jika Anda tidak menggunakannya untuk hal selain CocoaPods.

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

1. Dari setelan konfigurasi project Xcode, temukan Framework, Library, dan Embedded Content. Gunakan tanda minus(-) untuk menghapus framework berikut:
   • GoogleMaps
   • GoogleMapsBase (Hanya untuk penginstalan sebelum versi 9.2.0)
   • GoogleMapsCore (Hanya untuk penginstalan sebelum versi 9.2.0)
   • GoogleMapsM4B (Hanya untuk penginstalan sebelum versi 9.0.0)
2. Dari direktori level teratas project Xcode Anda, hapus paket GoogleMaps.

Penginstalan Manual

Panduan ini menunjukkan cara menambahkan XCFrameworks yang berisi Maps 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 komputer yang menggunakan Apple silicon.

1. Download file biner dan resource SDK berikut:
   • GoogleMaps
   • GoogleMapsM4B
   • GoogleMapsResources
2. Ekstrak file untuk mengakses XCFrameworks dan resource.
3. Jika Anda belum memiliki project Xcode, buatlah sekarang dan simpan ke komputer lokal Anda. Jika Anda baru mengenal pengembangan iOS:
   1. Membuat project baru.
   2. Pilih template iOS > Aplikasi.
   3. Di layar opsi project:
      1. Masukkan Project Name.
      2. Catat nilai kolom ID paket. Anda dapat menggunakan nilai tersebut untuk membatasi kunci API di bawah.
      3. Tetapkan Antarmuka project ke Storyboard.
      4. Tetapkan Language ke Swift atau Objective-C.
4. Buka tab General. Tarik XCFramework berikut ke project Anda di bagian Frameworks, Libraries, dan Embedded Content. Pastikan untuk memilih Jangan Sematkan:
   • GoogleMaps.xcframework
5. Salin GoogleMaps.bundle dari GoogleMapsResources yang Anda download ke direktori level teratas project Xcode. Pastikan untuk memilih Salin item ke folder grup tujuan saat diminta.
6. Pilih project Anda dari Project Navigator, lalu pilih target aplikasi Anda.
7. Buka tab Build Phases untuk target aplikasi Anda. Dalam Link Binary with Libraries, tambahkan framework dan library berikut:
   • Accelerate.framework
   • Contacts.framework
   • CoreData.framework
   • CoreGraphics.framework
   • CoreImage.framework
   • CoreLocation.framework
   • CoreTelephony.framework
   • CoreText.framework
   • GLKit.framework
   • ImageIO.framework
   • libc++.tbd
   • libz.tbd
   • Metal.framework
   • OpenGLES.framework (Hanya jika Anda menggunakan OpenGL)
   • QuartzCore.framework
   • Security.framework
   • SystemConfiguration.framework
   • UIKit.framework

8. 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 panel Build Settings dari Basic ke All.

9. Untuk menginstal Places SDK for iOS XCFramework, lihat Memulai Places SDK for iOS.

CocoaPods

Maps SDK for iOS tersedia sebagai pod CocoaPods. 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 Maps SDK for iOS dan gunakan untuk menginstal API beserta dependensinya:

1. Jika Anda belum memiliki project Xcode, buatlah sekarang dan simpan ke komputer lokal Anda. Jika Anda baru mengenal pengembangan iOS:
   1. Membuat project baru.
   2. Pilih template iOS > Aplikasi.
   3. Di layar opsi project:
      1. Masukkan Project Name.
      2. Catat nilai kolom ID paket. Anda dapat menggunakan nilai tersebut untuk membatasi kunci API di bawah.
      3. Tetapkan Antarmuka project ke Storyboard.
      4. Tetapkan Language ke Swift atau Objective-C.
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 menyertakan dependensi yang Anda perlukan untuk Maps SDK for iOS:

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

   Pastikan untuk menjalankan pod outdated secara berkala guna mendeteksi kapan ada versi yang lebih baru untuk memastikan Anda selalu menggunakan versi terbaru. Jika perlu, upgrade ke versi terbaru.
4. Simpan Podfile.

5. Buka terminal dan buka 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 untuk project yang ada, ikuti langkah-langkah berikut:

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

Langkah 3: Tambahkan kunci API Anda ke project

Di Mendapatkan kunci API, Anda membuat kunci API untuk aplikasi Anda. Sekarang tambahkan kunci tersebut ke project Xcode Anda.

Pada contoh berikut, ganti YOUR_API_KEY dengan kunci API Anda.

Catatan: Jika Anda mencatat ID paket project, atau mendapatkannya dari properti project, Anda dapat menggunakannya untuk membatasi kunci API agar hanya digunakan dengan aplikasi iOS dengan ID paket tertentu tersebut. Lihat Membatasi kunci API untuk mengetahui informasi selengkapnya.

Swift

Tambahkan kunci API ke AppDelegate.swift sebagai berikut:

1. Tambahkan pernyataan impor berikut:

   import GoogleMaps

2. Tambahkan hal berikut ke metode application(_:didFinishLaunchingWithOptions:) Anda, menggunakan kunci API Anda:

   GMSServices.provideAPIKey("YOUR_API_KEY")

3. Jika Anda juga menggunakan Places API, tambahkan kunci Anda lagi seperti yang ditunjukkan di sini:

   GMSPlacesClient.provideAPIKey("YOUR_API_KEY")

Objective-C

Tambahkan kunci API ke AppDelegate.m sebagai berikut:

1. Tambahkan pernyataan impor berikut:

   @import GoogleMaps;

2. Tambahkan hal berikut ke metode application:didFinishLaunchingWithOptions: Anda, menggunakan kunci API Anda:

   [GMSServices provideAPIKey:@"YOUR_API_KEY"];

3. Jika Anda juga menggunakan Places API, tambahkan kunci Anda lagi seperti yang ditunjukkan di sini:

   [GMSPlacesClient provideAPIKey:@"YOUR_API_KEY"];

Langkah 4 (opsional): Periksa file Manifes Privasi Apple

Catatan: Hal berikut relevan saat Anda men-deploy aplikasi ke app store web.

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 kontennya, buat arsip aplikasi Anda dan buat laporan privasi dari arsip tersebut.

Langkah 5 (opsional): Deklarasikan skema URL yang digunakan oleh API

Mulai iOS 9 dan Xcode 7, aplikasi dapat mendeklarasikan skema URL yang ingin dibuka, dengan menentukan skema dalam file Info.plist aplikasi. Maps SDK for iOS membuka aplikasi seluler Google Maps saat pengguna mengklik logo Google di peta, sehingga aplikasi Anda dapat mendeklarasikan skema URL yang relevan.

Untuk mendeklarasikan skema URL yang digunakan oleh Maps SDK for iOS, tambahkan baris berikut ke Info.plist:

 <key>LSApplicationQueriesSchemes</key>
 <array>
        <string>googlechromes</string>
        <string>comgooglemaps</string>
    </array>

Tangkapan layar berikut menampilkan konfigurasi dalam antarmuka pengguna Xcode:

Tanpa deklarasi di atas, error berikut dapat terjadi saat pengguna mengetuk logo Google di peta:

• -canOpenURL: failed for URL: "comgooglemaps://" - error: "This app is not allowed to query for scheme comgooglemaps"
• -canOpenURL: failed for URL: "googlechromes://" - error: "This app is not allowed to query for scheme googlechromes"

Untuk menghilangkan error ini, tambahkan deklarasi ke Info.plist Anda.

Langkah berikutnya

Setelah memiliki kunci API dan project Xcode, Anda dapat membuat dan menjalankan aplikasi. Navigation SDK for iOS menyediakan banyak tutorial dan aplikasi contoh yang dapat membantu Anda memulai. Untuk mengetahui detail selengkapnya, lihat:

• Tutorial berikut direkomendasikan sebagai titik awal:
  • Menambahkan Peta dengan Penanda.
  • Pilih Lokasi Saat Ini dan Menampilkan Detail pada Peta.
  • Geocoding Terbalik.
• Lihat contoh kode dan codelabs yang tersedia.
• Untuk solusi menyeluruh, tinjau Solusi Maps yang tersedia.