הגדרה והדגמה

בחירת פלטפורמה: Android iOS

בדף הזה מוסבר איך מגדירים את ספריית התשתיות ל-SDK של מפות Google ל-iOS.

כדי לנסות את הכלים האלה, אפשר:

אפשר גם להתקין את CocoaPods

ספריית כלי העזר זמינה כ-pod של CocoaPods בשם Google-Maps-iOS-Utils. CocoaPods היא מנהלת יחסי תלות של קוד פתוח בפרויקטים של Swift ו-Objective-C Cocoa.

אם הכלי CocoaPods עדיין לא מותקן, מריצים את הפקודה הבאה מהטרמינל כדי להתקין אותו ב-macOS:

sudo gem install cocoapods

פרטים נוספים זמינים במדריך לתחילת העבודה של CocoaPods.

התקנה והפעלה של אפליקציית ההדגמה

ספריית כלי השירות כוללת אפליקציית הדגמה שניתן להתקין ולאחר מכן לנסות כל כלי עזר.

מתקינים את אפליקציית ההדגמה באחת משתי השיטות הבאות:

שימוש בקבצים מ-GitHub

  1. מורידים את הארכיון של דוגמת הקוד מ-GitHub ופורקים את הארכיון.
  2. פותחים חלון טרמינל, עוברים לספרייה שבה הרחבתם את הקבצים לדוגמה ומציגים פירוט של ספריית הדוגמאות המתאימה לשפה שבה רוצים להשתמש:
    • עבור Swift, יש להריץ cd google-maps-ios-utils-master/samples/SwiftDemoApp
    • עבור יעד-C, מריצים את cd google-maps-ios-utils-master/samples/ObjCDemoApp
  3. מריצים את הפקודה הבאה:
    pod install
  4. סוגרים את Xcode ופותחים (לוחצים לחיצה כפולה) את הקובץ .xcworkspace של הפרויקט כדי להפעיל את Xcode. מרגע זה ואילך צריך להשתמש בקובץ .xcworkspace כדי לפתוח את הפרויקט.

שימוש ב-CocoaPods v1.6.1

  1. פותחים חלון טרמינל ומתקינים את גרסה 1.6.1: 
    sudo gem install cocoapods -v1.6.1
  2. מאחזרים את הקבצים של מפות Google באמצעות Cocoapods: 
    pod try Google-Maps-iOS-Utils

    כאשר מופיעה ההנחיה, בוחרים ב-Swift או ב-Objective-C. חברת CocoaPods מעדכנת את מאגרי המפרט, ואז פותחת את ההדגמה בפרויקט Xcode זמני בשם SwiftDemoApp.xcodeproj או ObjCDemoApp.xcodeproj.

הוספת מפתח ה-API לאפליקציית ההדגמה

בקטע קבלת מפתח API, יוצרים מפתח API לאפליקציה. עכשיו צריך להוסיף את המפתח הזה לפרויקט ה-Xcode של אפליקציית ההדגמה.

Swift

מוסיפים את מפתח ה-API ל-AppDelegate.swift באופן הבא:

  1. מוסיפים את הצהרת הייבוא הבאה: 
    import GoogleMaps
  2. עורכים את השורה הבאה כדי להוסיף את מפתח ה-API בין המירכאות הכפולות: 
    // Change this key to a valid key registered with the demo app bundle id.
let mapsAPIKey = ""

Objective-C

מוסיפים את מפתח ה-API ל-AppDelegate.m באופן הבא:

  1. מוסיפים את הצהרת הייבוא הבאה: 
    @import GoogleMaps;
  2. עורכים את השורה הבאה כדי להוסיף את מפתח ה-API בין המירכאות הכפולות: 
    // Change this key to a valid key registered with the demo app bundle id.
static NSString *const kMapsAPIKey = @"";

יצירה והפעלה של אפליקציית ההדגמה

אחרי שמוסיפים את מפתח ה-API, יוצרים ומפעילים את הפרויקט:

  • אם פועלת גרסת Swift של ההדגמה, ניתן לבחור את כלי העזר שיוצג באפליקציה.
  • אם מפעילים את גרסת Objective-C של ההדגמה, רואים את ההדגמה של כלי העזר לאשכולות סמנים. לאחר מכן תוכלו לערוך את גרסת Objective-C של ההדגמה כדי לנסות כל כלי עזר. מידע נוסף זמין בקטע הוספת כלי עזר לאפליקציה שבהמשך.

התקנה של ספריית הכלים כפרויקט Xcode

כך מוסיפים את ספריית כלי העזר לסביבת העבודה של Xcode:

שימוש ב-CocoaPods

  1. אם עדיין אין לך פרויקט ב-Xcode, צריך ליצור פרויקט עכשיו ולשמור אותו במחשב המקומי. (אם אתם מפתחים חדשים ל-iOS, צרו אפליקציה עם תצוגה יחידה.)
  2. אם עדיין אין לפרויקט קובץ pod, צריך ליצור קובץ בשם Podfile בספריית הפרויקט. הקובץ הזה מגדיר את יחסי התלות של הפרויקט שלכם.
  3. עורכים את קובץ ה-pod של הפרויקט ומוסיפים תלות ב-pod של Google-Maps-iOS-Utils. הדוגמה הבאה כוללת את יחסי התלות הנדרשים עבור ה-SDK של מפות Google ל-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' בקובץ ה-pod.

שימוש ב-Carthage

  1. התקן את Carthage. יש כמה שיטות, ולכן כדאי לעיין בקובץ ה-README של Carthage כדי לראות את השלבים המדויקים.
  2. אם עדיין אין לך פרויקט ב-Xcode, צריך ליצור פרויקט עכשיו ולשמור אותו במחשב המקומי. (אם אתם מתחילים את הפיתוח ל-iOS, צרו פרויקט חדש ובחרו את תבנית האפליקציה ל-iOS. ב-Xcode 11.7 או בגרסאות קודמות, יוצרים אפליקציית 'תצוגה יחידה'.)
  3. יוצרים קובץ בשם Cartfile בספריית הפרויקט. הקובץ הזה מגדיר את יחסי התלות של הפרויקט שלכם.
  4. עורכים את ה-Cartfile ומוסיפים את ה-SDK של מפות Google לספריות תשתיות של iOS:
    github "googlemaps/google-maps-ios-utils"
  5. שומרים את Cartfile.
  6. בחלון הטרמינל, עוברים לספרייה שמכילה את Cartfile:
    cd <path-to-project>
  7. מריצים את פקודת העדכון:
    carthage update --platform iOS

    הפעולה הזו תתקין את ממשקי ה-API שצוינו ב-Cartfile, יחד עם כל יחסי התלות שלהם.
  8. ב-Finder, בספריית הפרויקט, נכנסים לקובצי ה-framework שהורדתם בקטע Carthage/Build/iOS.
  9. כדי להוסיף לפרויקט את ה-SDK של מפות ל-iOS, גוררים את החבילות הבאות לפרויקט. (כשמוצגת הבקשה, בוחרים באפשרות העתקת פריטים לפי הצורך, יש להשתמש באותה גרסה שצוינה למעלה.)
    • GoogleMaps-x.x.x/Base/Frameworks/GoogleMapsBase.framework
    • GoogleMaps-x.x.x/Maps/Frameworks/GoogleMaps.framework
    • GoogleMaps-x.x.x/Maps/Frameworks/GoogleMapsCore.framework
    • GoogleMaps-x.x.x/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 שלבים (יצירת שלבים) ביעד של האפליקציה, ובתוך Link Binary with Libraries (קישור של 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 (הגדרות build). בקטע Other Links flags מוסיפים את -ObjC. אם ההגדרות האלה לא מוצגות, משנים את המסנן בסרגל Build Settings (הגדרות Build) מ-Basic (בסיסי) ל-All (הכול).

שימוש במנהל החבילות של Swift

  1. אם עדיין אין לכם פרויקט ב-Xcode, צריך ליצור פרויקט עכשיו ולשמור אותו במחשב המקומי. (אם זו הפעם הראשונה שאתם עובדים על פיתוח ל-iOS, תוכלו ליצור פרויקט חדש ולבחור את תבנית האפליקציה ל-iOS. ב-Xcode מגרסה 11.7 ואילך, יוצרים אפליקציה לתצוגה יחידה.)
  2. הוסף את ה-SDK של מפות Google ל-iOS כתלוי. האפשרויות מפורטות במאמר התקנת ה-SDK.
  3. בפרויקט Xcode, עוברים אל File -> Swift Packages -> Add Package Dependency.
  4. בחלון שמוצג, מזינים את ה-SDK של מפות Google למאגר המאגר של ספריית הכלים ל-iOS https://github.com/googlemaps/google-maps-ios-utils ובוחרים באפשרות Next.
    • בשלב הזה ייתכן שתתבקשו לבצע אימות באמצעות חשבון GitHub שלכם. פועלים לפי ההוראות כדי ליצור אסימון גישה אישי של GitHub כדי להמשיך בתהליך.
  5. בחלון הבא, בוחרים באפשרות הרדיו Version, בוחרים באפשרות Exact מהרשימה הנפתחת, מזינים את הגרסה האחרונה של Maps SDK עבור iOS Utility Library (למשל "3.4.0") ובוחרים באפשרות Next.

הוספה של מפתח ה-API לאפליקציה

במאמר הגדרת פרויקט Xcode מפורטות הוראות ליצירת מפתח API ולהוספה שלו לפרויקט Xcode.

יצירה והפעלה של הפרויקט

אחרי שמוסיפים את מפתח ה-API, צריך ליצור ולהפעיל את הפרויקט.

הוספת כלי עזר לאפליקציה

במסמכי התיעוד של כל כלי אפשר לקרוא מידע נוסף על השימוש בו באפליקציה: