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 Dependency Rule ke salah satu opsi berbasis versi. Untuk project baru, sebaiknya tentukan versi terbaru dan gunakan opsi "Exact Version". Setelah selesai, klik "Add Package".
4. Dari jendela Choose Package Products, pastikan GoogleMaps (untuk versi sebelum 9.0.0, pastikan GoogleMaps, GoogleMapsBase, dan GoogleMapsCore) akan ditambahkan ke target main yang ditentukan. Setelah selesai, klik "Add Package".
5. Untuk memverifikasi penginstalan, buka panel General target Anda. Di Frameworks, Libraries, and Embedded Content , Anda akan melihat paket yang diinstal. Anda juga dapat melihat bagian "Package Dependencies" dari "Project Navigator" untuk memverifikasi paket dan versinya.

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

1. Jika Anda mengupgrade dari versi sebelum 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 Anda, temukan Frameworks, Libraries, and Embedded Content. Gunakan tanda minus(-) untuk menghapus framework berikut:

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

Untuk menghapus dependensi Maps SDK for iOS yang ada dan 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 Anda, temukan Frameworks, Libraries, and 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 GoogleMaps paket.

Penginstalan Manual

Panduan ini menjelaskan 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 Anda gunakan di beberapa platform, termasuk mesin yang menggunakan Apple silicon.

1. Download file biner dan resource SDK berikut:
   • GoogleMaps
   • 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 menggunakan pengembangan iOS:
   1. Buat project baru.
   2. Pilih template iOS > App.
   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 Interface project ke Storyboard.
      4. Tetapkan Language ke Swift atau Objective-C.
4. Buka tab General. Tarik XCFrameworks berikut ke project Anda di bagian Frameworks, Libraries, and Embedded Content. Pastikan untuk memilih Do Not Embed:
   • 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 Navigator Project, lalu pilih sasaran aplikasi Anda.
7. Buka tab Build Phases untuk sasaran aplikasi Anda. Di bagian 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
   • MetricKit.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 Places SDK for iOS XCFramework, lihat Memulai dengan Places SDK for iOS.

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