Menyiapkan project Xcode

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.

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

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

1. Jika Anda 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 mengetahui informasi selengkapnya, lihat Catatan Rilis Versi 9.0.0.

   Dari setelan konfigurasi project Xcode, temukan Frameworks, Libraries, 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.

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 Xcode workspace jika Anda tidak menggunakannya untuk hal lain selain CocoaPods.

1. Dari setelan konfigurasi project Xcode, temukan Frameworks, Libraries, and Embedded Content. Gunakan tanda minus(-) untuk menghapus framework berikut:
   • GoogleMaps
   • GoogleMapsBase (Hanya untuk penginstalan yang lebih lama dari versi 9.2.0)
   • GoogleMapsCore (Hanya untuk penginstalan yang lebih lama dari versi 9.2.0)
   • GoogleMapsM4B (Hanya untuk penginstalan sebelum versi 9.0.0)
2. Dari direktori level teratas project Xcode, hapus paket GoogleMaps.

Penginstalan Manual

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

1. Download file biner dan file resource SDK berikut:
   • GoogleMaps
   • GoogleMapsResources
2. Ekstrak file untuk mengakses XCFramework dan resource.
3. Jika Anda belum memiliki project Xcode, buatlah sekarang dan simpan ke komputer lokal Anda. Jika Anda baru dalam pengembangan iOS:
   1. Membuat project baru.
   2. Pilih template iOS > Aplikasi.
   3. Di layar opsi project:
      1. Masukkan Nama Project.
      2. Catat nilai kolom ID paket. Anda dapat menggunakan nilai tersebut untuk membatasi kunci API Anda di bawah.
      3. Setel Interface project ke Storyboard.
      4. Setel Language ke Swift atau Objective-C.
4. Buka tab Umum. Tarik XCFramework berikut ke project Anda di bagian Frameworks, Libraries, and Embedded Content. Pastikan untuk memilih Jangan Sematkan:
   • GoogleMaps.xcframework
5. Salin GoogleMaps.bundle dari GoogleMapsResources yang Anda download ke direktori level teratas project Xcode Anda. Pastikan untuk memilih Copy items into destination group's folder 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 bar Build Settings dari Basic ke All.

9. Untuk menginstal XCFramework Places SDK for iOS, lihat Mulai 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 dalam pengembangan iOS:
   1. Membuat project baru.
   2. Pilih template iOS > Aplikasi.
   3. Di layar opsi project:
      1. Masukkan Nama Project.
      2. Catat nilai kolom ID paket. Anda dapat menggunakan nilai tersebut untuk membatasi kunci API Anda di bawah.
      3. Setel Interface project ke Storyboard.
      4. Setel 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', '10.1.0'
   end

   Jalankan pod outdated secara rutin untuk mendeteksi jika ada versi yang lebih baru guna memastikan Anda selalu menggunakan versi terbaru. Jika perlu, lakukan upgrade ke 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.

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"];