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

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

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

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

Maps SDK for iOS Utility Library را به پروژه Xcode اضافه کنید

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

از 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 را انتخاب کنید، از لیست کشویی Up to Next Major Version را انتخاب کنید و آخرین نسخه Maps SDK for iOS Utility Library را وارد کنید (به عنوان مثال، "6.0.0").
  6. روی منوی کشویی کنار افزودن به پروژه کلیک کنید، پروژه خود را انتخاب کنید و افزودن بسته را انتخاب کنید.

از 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, '15.0'

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

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

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

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

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

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

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

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

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

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

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

از فایل های 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 نسخه آزمایشی را ویرایش کنید تا هر برنامه کاربردی را امتحان کنید. برای اطلاعات بیشتر به بخش افزودن ابزار به برنامه خود در زیر مراجعه کنید.