راه اندازی و نسخه ی نمایشی

پلتفرم را انتخاب کنید: Android iOS

این صفحه نحوه راه‌اندازی کتابخانه ابزار برای Maps SDK برای iOS را شرح می‌دهد.

برای امتحان این ابزارهای کمکی، می توانید یکی از موارد زیر را انجام دهید:

به صورت اختیاری CocoaPods را نصب کنید

کتابخانه ابزار به صورت یک غلاف CocoaPods با نام Google-Maps-iOS-Utils در دسترس است. CocoaPods یک مدیر وابستگی منبع باز برای پروژه های Swift و Objective-C Cocoa است.

اگر قبلاً ابزار CocoaPods را ندارید، با اجرای دستور زیر از ترمینال، آن را روی macOS نصب کنید:

sudo gem install cocoapods

برای جزئیات، به راهنمای شروع به کار CocoaPods مراجعه کنید.

برنامه دمو را نصب و اجرا کنید

کتابخانه ابزار شامل یک برنامه آزمایشی است که می توانید آن را نصب کنید و سپس هر برنامه کاربردی را امتحان کنید.

برنامه دمو را با استفاده از یکی از این دو روش نصب کنید:

از فایل های GitHub استفاده کنید

  1. آرشیو نمونه کد را از گیت هاب دانلود کنید و آرشیو را از حالت بسته خارج کنید.
  2. یک پنجره ترمینال را باز کنید، به دایرکتوری بروید که در آن فایل های نمونه را گسترش داده اید، و در پوشه نمونه های مناسب برای زبانی که می خواهید استفاده کنید، بیایید:
    • برای Swift، cd google-maps-ios-utils-master/samples/SwiftDemoApp را اجرا کنید
    • برای Objective-C، cd google-maps-ios-utils-master/samples/ObjCDemoApp را اجرا کنید
  3. دستور زیر را اجرا کنید:
    pod install
  4. Xcode را ببندید و سپس فایل .xcworkspace پروژه خود را باز کنید (دوبار کلیک کنید) تا Xcode راه اندازی شود. از این زمان به بعد باید از فایل .xcworkspace برای باز کردن پروژه استفاده کنید.

از CocoaPods نسخه 1.6.1 استفاده کنید

  1. یک پنجره ترمینال را باز کنید و نسخه 1.6.1: 
    sudo gem install cocoapods -v1.6.1
    را نصب کنید
  2. فایل‌های Google Maps را با استفاده از Cocoapods: 
    pod try Google-Maps-iOS-Utils
    واکشی کنید

    وقتی از شما خواسته شد Swift یا Objective-C را انتخاب کنید. CocoaPods مخازن مشخصات شما را به روز می کند، سپس نسخه آزمایشی را در یک پروژه موقت Xcode به نام SwiftDemoApp.xcodeproj یا ObjCDemoApp.xcodeproj باز می کند.

کلید API را به برنامه آزمایشی اضافه کنید

در دریافت کلید API ، یک کلید API برای برنامه خود ایجاد می کنید. اکنون آن کلید را به پروژه Xcode برای برنامه آزمایشی اضافه کنید.

سریع

کلید API خود را به صورت زیر به AppDelegate.swift خود اضافه کنید:

  1. عبارت import زیر را اضافه کنید: 
    import GoogleMaps
  2. خط زیر را ویرایش کنید تا کلید API خود را بین دو نقل قول اضافه کنید: 
    // Change this key to a valid key registered with the demo app bundle id.
let mapsAPIKey = ""

هدف-C

کلید API خود را به صورت زیر به AppDelegate.m خود اضافه کنید:

  1. عبارت import زیر را اضافه کنید: 
    @import GoogleMaps;
  2. خط زیر را ویرایش کنید تا کلید API خود را بین دو نقل قول اضافه کنید: 
    // Change this key to a valid key registered with the demo app bundle id.
static NSString *const kMapsAPIKey = @"";

اپلیکیشن دمو را بسازید و اجرا کنید

بعد از اینکه کلید API را اضافه کردید، پروژه را بسازید و اجرا کنید:

  • اگر نسخه آزمایشی سویفت را اجرا می‌کنید، می‌توانید برنامه کاربردی را برای مشاهده در برنامه انتخاب کنید.
  • اگر نسخه ی Objective-C نسخه ی نمایشی را اجرا می کنید، نسخه ی نمایشی ابزار خوشه بندی نشانگر را مشاهده می کنید. سپس می‌توانید نسخه Objective-C نسخه آزمایشی را ویرایش کنید تا هر برنامه کاربردی را امتحان کنید. برای اطلاعات بیشتر به بخش افزودن ابزار به برنامه خود در زیر مراجعه کنید.

کتابخانه ابزار را به عنوان یک پروژه Xcode نصب کنید

این مراحل را برای افزودن کتابخانه ابزار به فضای کاری Xcode خود دنبال کنید:

از CocoaPods استفاده کنید

  1. اگر هنوز پروژه Xcode ندارید، اکنون یکی را ایجاد کرده و آن را در دستگاه محلی خود ذخیره کنید. (اگر در توسعه iOS تازه کار هستید، یک برنامه Single View ایجاد کنید.)
  2. اگر قبلاً یک فایل پاد برای پروژه خود ندارید، یک فایل به نام Podfile در فهرست پروژه خود ایجاد کنید. این فایل وابستگی های پروژه شما را تعریف می کند.
  3. فایل پاد پروژه خود را ویرایش کنید و یک وابستگی به غلاف Google-Maps-iOS-Utils اضافه کنید. در اینجا یک مثال است که شامل وابستگی‌هایی است که برای Maps SDK برای iOS و کتابخانه ابزار نیاز دارید:
    source 'https://github.com/CocoaPods/Specs.git'
platform :ios, '13.0'

target 'YOUR_APPLICATION_TARGET_NAME_HERE' do
  use_frameworks!
  pod 'GoogleMaps', '7.4.0'
  pod 'Google-Maps-iOS-Utils', '4.2.2'
end
  4. pod install اجرا کنید.
  5. Xcode را ببندید و سپس فایل .xcworkspace پروژه خود را باز کنید (دوبار کلیک کنید) تا Xcode راه اندازی شود. از این زمان به بعد باید از فایل .xcworkspace برای باز کردن پروژه استفاده کنید.

توجه: ابزار خوشه‌بندی نشانگر به چهار درخت وابسته است، اما می‌توانید از چهار درخت بدون خوشه‌بندی نشانگر استفاده کنید. اگر فقط ابزار quadtree را می‌خواهید، می‌توانید pod 'Google-Maps-iOS-Utils' به 'Google-Maps-iOS-Utils/QuadTree' در فایل پاد خود تغییر دهید.

از کارتاژ استفاده کنید

  1. کارتاژ را نصب کنید. روش های مختلفی وجود دارد، بنابراین برای اطلاع از مراحل دقیق ، فایل Carthage README را ببینید .
  2. اگر هنوز پروژه Xcode ندارید، اکنون یکی را ایجاد کرده و آن را در دستگاه محلی خود ذخیره کنید. (اگر در توسعه iOS جدیدتر هستید، یک پروژه جدید ایجاد کنید و الگوی برنامه iOS را انتخاب کنید. در Xcode 11.7 یا نسخه‌های قبلی، یک برنامه Single View ایجاد کنید.)
  3. یک فایل به نام Cartfile در دایرکتوری پروژه خود ایجاد کنید. این فایل وابستگی های پروژه شما را تعریف می کند.
  4. Cartfile را ویرایش کرده و وابستگی Maps SDK برای iOS Utility Library را اضافه کنید:
    github "googlemaps/google-maps-ios-utils"
  5. Cartfile ذخیره کنید.
  6. در یک پنجره ترمینال، به دایرکتوری حاوی Cartfile بروید:
    cd <path-to-project>
  7. دستور به روز رسانی را اجرا کنید:
    carthage update --platform iOS

    این API های مشخص شده در Cartfile را به همراه وابستگی هایی که ممکن است داشته باشند نصب می کند.
  8. در Finder، در فهرست پروژه خود، به فایل های فریمورک دانلود شده در Carthage/Build/iOS بروید.
  9. با کشیدن بسته‌های زیر به پروژه خود، Maps SDK برای چارچوب‌های iOS را به پروژه خود اضافه کنید. (در صورت نیاز، کپی موارد را انتخاب کنید، لطفاً از همان نسخه بالا استفاده کنید. )
    • GoogleMaps-xxx/Base/Frameworks/GoogleMapsBase.framework
    • GoogleMaps-xxx/Maps/Frameworks/GoogleMaps.framework
    • GoogleMaps-xxx/Maps/Frameworks/GoogleMapsCore.framework
    • GoogleMaps-xxx/Maps/Frameworks/GoogleMapsUtils.framework
  10. روی GoogleMaps.framework در پروژه خود کلیک راست کرده و Show In Finder را انتخاب کنید.
  11. Carthage/Build/iOS/GoogleMaps.framework/Resources/GoogleMaps.bundle از پوشه Resources به داخل پروژه خود بکشید. هنگامی که از شما خواسته شد، مطمئن شوید که موارد کپی در پوشه گروه مقصد انتخاب نشده است.
  12. پروژه خود را از Project Navigator انتخاب کنید و هدف برنامه خود را انتخاب کنید.
  13. تب Build Phases را برای هدف برنامه خود باز کنید و در Link Binary with Libraries ، چارچوب های زیر را اضافه کنید:
    • Accelerate.framework
    • CoreData.framework
    • CoreGraphics.framework
    • CoreImage.framework
    • CoreLocation.framework
    • CoreTelephony.framework
    • CoreText.framework
    • GLKit.framework
    • ImageIO.framework
    • libc++.tbd
    • libz.tbd
    • OpenGLES.framework
    • QuartzCore.framework
    • SystemConfiguration.framework
    • UIKit.framework

  14. پروژه خود را به جای یک هدف خاص انتخاب کنید و تب Build Settings را باز کنید. در بخش Other Linker Flags ، -ObjC اضافه کنید. اگر این تنظیمات قابل مشاهده نیستند، فیلتر موجود در نوار تنظیمات ساخت را از Basic به All تغییر دهید.

از Swift Package Manager استفاده کنید

  1. اگر هنوز پروژه Xcode ندارید، اکنون یکی را ایجاد کرده و آن را در دستگاه محلی خود ذخیره کنید. (اگر در توسعه iOS تازه کار هستید، یک پروژه جدید ایجاد کنید و الگوی برنامه iOS را انتخاب کنید. در Xcode 11.7 یا بالاتر، یک برنامه Single View ایجاد کنید.)
  2. Maps SDK برای iOS را به عنوان یک وابستگی اضافه کنید. برای مشاهده گزینه ها به نصب SDK مراجعه کنید.
  3. در پروژه Xcode خود، به File -> Swift Packages -> Add Package Dependency بروید.
  4. در پنجره ارائه شده، URL مخزن کتابخانه ابزار کاربردی Maps SDK برای iOS را وارد کنید https://github.com/googlemaps/google-maps-ios-utils و Next را انتخاب کنید.
    • در این مرحله، ممکن است از شما خواسته شود که با حساب GitHub خود احراز هویت کنید. دستورالعمل ها را برای ایجاد یک نشانه دسترسی شخصی GitHub برای ادامه فرآیند دنبال کنید.
  5. در پنجره بعدی، گزینه Version radio را انتخاب کنید، از لیست کشویی Exact را انتخاب کنید، آخرین نسخه Maps SDK for iOS Utility Library (به عنوان مثال "3.4.0") را وارد کنید و Next را انتخاب کنید.

کلید API را به برنامه خود اضافه کنید

برای دستورالعمل‌های مربوط به تولید کلید API و افزودن آن به پروژه Xcode خود ، به راه‌اندازی یک پروژه Xcode رجوع کنید.

پروژه را بسازید و اجرا کنید

بعد از اینکه کلید API را اضافه کردید، پروژه را بسازید و اجرا کنید.

یک ابزار به برنامه خود اضافه کنید

برای اطلاعات بیشتر در مورد استفاده از آن در برنامه خود، اسناد مربوط به هر ابزار را ببینید: