Xcode projesi oluşturma

Faturalandırmayı etkinleştirip bir API anahtarı oluşturduktan sonra uygulamanızı geliştirmek için kullandığınız Xcode projesini ayarlamaya hazırsınız.

Her sürüm için sürüm notları mevcuttur.

1. adım: Gerekli yazılımı yükleyin

iOS için Yerler SDK'sını kullanarak proje oluşturmak için gerekenler:

• Xcode 16.0 veya sonraki sürümler

2. adım: Xcode projesini oluşturun ve iOS için Yerler SDK'sını yükleyin

Swift Package Manager

iOS için Yerler SDK'sı, Swift Package Manager aracılığıyla yüklenebilir. SDK'yı eklemek için mevcut Places SDK for iOS bağımlılıklarını kaldırdığınızdan emin olun.

Önemli: Bu talimatlarda Xcode 15 veya sonraki sürümlerin kullanıldığı varsayılmaktadır ancak önceki Xcode sürümlerinde de benzer şekilde uygulanabilir.

SDK'yı yeni veya mevcut bir projeye eklemek için aşağıdaki adımları uygulayın:

1. Xcode'unuzu project veya workspace açın, ardından File > Add Package Dependencies'e (Dosya > Paket Bağımlılıkları Ekle) gidin.
2. URL olarak https://github.com/googlemaps/ios-places-sdk adresini girin, paketi çekmek için Enter tuşuna basın ve "Add Package" (Paket Ekle) seçeneğini tıklayın.
3. Belirli bir version yüklemek için Bağımlılık Kuralı alanını sürüm tabanlı seçeneklerden birine ayarlayın. Yeni projeler için en son sürümü belirtmenizi ve "Tam Sürüm" seçeneğini kullanmanızı öneririz. Bu işlem tamamlandıktan sonra "Paket Ekle"yi tıklayın.
4. Paket Ürünleri Seçin penceresinde, GooglePlaces, GooglePlacesSwift veya her ikisinin de belirlenen ana hedefinize ekleneceğini doğrulayın. Bu işlem tamamlandıktan sonra Paket Ekle'yi tıklayın.

   Google Places Swift'i kullanımdan kaldırılan GitHub URL'sinden güncelliyorsanız

   Önemli: Google Places Swift'e erişmek için kullanılan GitHub URL'si, 0.3.0 sürümünden itibaren değişti. Eski URL https://github.com/googlemaps/ios-places-swift-sdk üzerinden erişilen bir GooglePlacesSwift sürümünü güncelliyorsanız bu sürümü Xcode'un paket bağımlılıkları bölümünden kaldırın.

5. Yüklemenizi doğrulamak için hedefinizin Genel bölmesine gidin. Frameworks, Libraries, and Embedded Content (Çerçeveler, Kitaplıklar ve Yerleştirilmiş İçerik) bölümünde, yüklenen paketleri görürsünüz. Paketi ve sürümünü doğrulamak için Proje Gezgini'nin Paket Bağımlılıkları bölümünü de görüntüleyebilirsiniz.

Mevcut bir projenin package bölümünü güncellemek için aşağıdaki adımları uygulayın:

1. Xcode'da "File > Packages > Update To Latest Package Versions" (Dosya > Paketler > En Son Paket Sürümlerine Güncelle) seçeneğine gidin.

   Google Places Swift'i kullanımdan kaldırılan GitHub URL'sinden güncelliyorsanız

   Önemli: Google Places Swift'e erişmek için kullanılan GitHub URL'si, 0.3.0 sürümünden itibaren değişti. Eski URL https://github.com/googlemaps/ios-places-swift-sdk üzerinden erişilen bir GooglePlacesSwift sürümünü güncelliyorsanız bu sürümü Xcode'un paket bağımlılıkları bölümünden kaldırın.

2. Yüklemenizi doğrulamak için Paket Bağımlılıkları bölümüne giderek paketi ve sürümünü doğrulayın. Proje Gezgini'ni kullanın.

Önemli: Bazen yapay nesneler çözülemez veya hatalar oluşabilir. Bu durumda "Dosya > Paketler > Paket önbelleğini sıfırla"yı seçin.

Manuel olarak yüklenen mevcut iOS için Yerler SDK'sını kaldırmak istiyorsanız aşağıdaki adımları uygulayın:

1. Xcode proje yapılandırma ayarlarınızda Frameworks, Libraries, and Embedded Content'ı (Çerçeveler, Kitaplıklar ve Yerleştirilmiş İçerik) bulun. Aşağıdaki çerçeveleri kaldırmak için eksi işaretini(-) kullanın:
   • GooglePlaces.xcframework
   • GooglePlacesSwift.xcframework
2. Xcode projenizin üst düzey dizininden GooglePlaces paketini kaldırın.

Manuel yükleme

Bu kılavuzda, iOS için Places SDK ve iOS için Places Swift SDK'yı içeren XCFramework'leri projenize manuel olarak nasıl ekleyeceğiniz ve Xcode'da derleme ayarlarınızı nasıl yapılandıracağınız gösterilmektedir. XCFramework, Apple çipli makineler de dahil olmak üzere birden fazla platformda kullanabileceğiniz bir ikili pakettir. iOS için Yerler SDK'sı, iOS için Yerler Swift SDK'sı veya her ikisini de ekleyebilirsiniz.

1. Aşağıdaki SDK ikili ve kaynak dosyalarını indirin:
   • GooglePlaces
   • GooglePlacesResources
2. iOS için Places Swift SDK'sını yüklüyorsanız aşağıdaki dosyaları yükleyin:
   • GooglePlacesSwift
   • GooglePlacesSwiftResources
3. XCFramework'e ve kaynaklara erişmek için dosyaları çıkarın.
4. Xcode'u başlatın ve mevcut bir projeyi açın veya yeni bir proje oluşturun. iOS geliştirmeye yeni başladıysanız yeni bir proje oluşturun ve iOS App template'i (iOS uygulama şablonu) seçin.
5. Önceki sürümlerdeki Haritalar paketlerini projenizden kaldırın.
6. Genel sekmesini açın. Aşağıdaki XCFramework'ü Frameworks, Libraries, and Embedded Content (Framework'ler, Kitaplıklar ve Yerleştirilmiş İçerik) bölümünde projenize sürükleyin. Yerleştirme'yi seçtiğinizden emin olun:
   • GooglePlaces.xcframework
   Places Swift SDK'sını yüklüyorsanız aşağıdaki XCFramework'ü Frameworks, Libraries, and Embedded Content bölümünde projenize sürükleyin. Yerleştirme'yi seçtiğinizden emin olun:
   • GooglePlacesSwift.xcframework
7. İndirdiğiniz GooglePlacesResources'taki GooglePlaces.bundle dosyasını Xcode projenizin en üst düzey dizinine kopyalayın. İstendiğinde Öğeleri hedef grubun klasörüne kopyala'yı seçtiğinizden emin olun.
   
   Places Swift SDK'yı yüklüyorsanız indirdiğiniz GooglePlacesSwiftResources'taki GooglePlacesSwift.bundle öğesini Xcode projenizin en üst düzey dizinine kopyalayın. İstendiğinde Öğeleri hedef grubun klasörüne kopyala'yı seçtiğinizden emin olun.
8. Proje Gezgini'nden projenizi seçin ve uygulamanızın hedefini belirleyin.
9. Build Phases (Derleme Aşamaları) sekmesini açın. Link Binary with Libraries bölümünde aşağıdaki çerçeveleri ve kitaplıkları ekleyin:
   • CoreGraphics.framework
   • CoreLocation.framework
   • libc++.tbd
   • libz.tbd
   • QuartzCore.framework
   • UIKit.framework

10. Belirli bir hedef yerine projenizi seçin ve Build Settings (Derleme Ayarları) sekmesini açın. Linking - General -> Other Linker Flags (Bağlantı - Genel -> Diğer Bağlayıcı İşaretleri) bölümünde, "Debug" (Hata Ayıklama) ve "Release" (Yayın) alanlarına -ObjC ekleyin. Bu ayarlar görünmüyorsa Derleme Ayarları çubuğundaki filtreyi Temel'den Tümü'ne değiştirin.

CocoaPods

iOS için Yerler SDK'sı ve iOS için Yerler Swift SDK'sı, CocoaPod pod'ları GooglePlaces ve GooglePlacesSwift olarak kullanılabilir.

CocoaPods, Swift ve Objective-C Cocoa projeleri için açık kaynaklı bir bağımlılık yöneticisidir. CocoaPods aracınız yoksa terminalden aşağıdaki komutu çalıştırarak macOS'e yükleyin. Ayrıntılar için CocoaPods'u Kullanmaya Başlama Kılavuzu'na bakın.

sudo gem install cocoapods

SDK'ları ve bağımlılıklarını yüklemek için bir Podfile oluşturun:

1. Henüz bir Xcode projeniz yoksa hemen bir proje oluşturun ve yerel makinenize kaydedin. iOS geliştirmeye yeni başladıysanız yeni bir proje oluşturun ve iOS App template'i (iOS uygulama şablonu) seçin.
2. Proje dizininizde Podfile adlı bir dosya oluşturun. Bu dosya, projenizin bağımlılıklarını tanımlar.
3. Podfile dosyasını düzenleyin ve bağımlılıklarınızı sürümleriyle birlikte ekleyin. Uygulama hedefinizin adını ve GooglePlaces ile GooglePlacesSwift pod'larının adlarını belirten bir örneği aşağıda bulabilirsiniz:

   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

   Her zaman en son sürümü kullandığınızdan emin olmak için pod outdated komutunu düzenli olarak çalıştırarak yeni bir sürümün ne zaman yayınlandığını tespit edin.
4. Podfile öğesini kaydedin.

5. Bir terminal açın ve Podfile içeren dizine gidin:

   cd <path-to-project>

6. pod install komutunu çalıştırın. Bu işlem, Podfile içinde belirtilen API'leri ve varsa bağımlılıklarını yükler.

   pod install

7. Xcode'u kapatın ve ardından Xcode'u başlatmak için projenizin .xcworkspace dosyasını açın (çift tıklayın). Bu tarihten itibaren projeyi açmak için .xcworkspace dosyasını kullanmanız gerekir.

Mevcut bir projenin API'sini güncellemek için aşağıdaki adımları uygulayın:

1. Bir terminal açıp Podfile dosyasını içeren proje dizinine gidin.
2. pod update komutunu çalıştırın. Bu işlem, Podfile içinde belirtilen tüm API'leri en yeni sürüme günceller.

3. adım: API anahtarını uygulamanıza ekleyin

Aşağıdaki örneklerde YOUR_API_KEY yerine API anahtarınızı girin.

GooglePlacesSwift

API anahtarınızı AppDelegate.swift dosyasına aşağıdaki şekilde ekleyin:

• Aşağıdaki içe aktarma ifadesini ekleyin:

  import GooglePlacesSwift

• application(_:didFinishLaunchingWithOptions:) yönteminize aşağıdakileri ekleyin. YOUR_API_KEY kısmını API anahtarınızla değiştirin:

  PlacesClient.provideAPIKey("YOUR_API_KEY")

Swift

API anahtarınızı AppDelegate.swift dosyasına aşağıdaki şekilde ekleyin:

• Aşağıdaki içe aktarma ifadesini ekleyin:

  import GooglePlaces

• application(_:didFinishLaunchingWithOptions:) yönteminize aşağıdakileri ekleyin. YOUR_API_KEY kısmını API anahtarınızla değiştirin:

  GMSPlacesClient.provideAPIKey("YOUR_API_KEY")

Objective-C

API anahtarınızı AppDelegate.m dosyasına aşağıdaki şekilde ekleyin:

• Aşağıdaki içe aktarma ifadesini ekleyin:

  @import GooglePlaces;

• application:didFinishLaunchingWithOptions: yönteminize aşağıdakileri ekleyin. YOUR_API_KEY kısmını API anahtarınızla değiştirin:

  [GMSPlacesClient provideAPIKey:@"YOUR_API_KEY"];

4. adım (isteğe bağlı): Apple Gizlilik Manifesti dosyasını inceleyin

Not: Aşağıdaki bilgiler, uygulamanızı web mağazasına dağıttığınızda geçerlidir.

Apple, App Store'daki uygulamalar için uygulama gizliliği ayrıntıları ister. Güncellemeler ve daha fazla bilgi için Apple App Store Gizlilik Ayrıntıları sayfasını ziyaret edin.

Apple Gizlilik Manifesti dosyası, SDK'nın kaynak paketine dahil edilir. Gizlilik manifest dosyasının dahil edildiğini doğrulamak ve içeriğini incelemek için uygulamanızın arşivini oluşturun ve arşivden gizlilik raporu oluşturun.

Sonraki adımlar

• Kod yazmaya başlayın. Kullanıcının mevcut yerini alan bir başlangıç uygulaması oluşturmak iyi bir başlangıç noktasıdır.
• Projeniz yapılandırıldıktan sonra örnek uygulamaları inceleyebilirsiniz.
• API anahtarınızın güvenliğini sağlamak için Uygulama Kontrolü'nü kullanın.