הגדרה והדגמה

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

1. אם עדיין לא יצרת פרויקט Xcode, עליך ליצור פרויקט עכשיו ולשמור אותו במחשב המקומי. (אם אין לכם ניסיון בפיתוח iOS, עליכם ליצור פרויקט חדש ולבחור באפליקציה ל-iOS? תבנית. ב-Xcode מגרסה 11.7 ואילך, יוצרים אפליקציה לתצוגה יחידה).
2. מוסיפים את ה-SDK של מפות Google ל-iOS כתלות. צפייה מתקינים את ה-SDK כדי להציג את האפשרויות.
3. בפרויקט Xcode, מנווטים אל File -> חבילות מהירות -> הוספת תלות בחבילה.
4. בחלון המוצג, מזינים את כתובת ה-URL של מאגר ה-SDK של מפות Google ל-iOS Utility Library https://github.com/googlemaps/google-maps-ios-utils ובוחרים באפשרות הבא.
• בשלב הזה, יכול להיות שתתבקשו לבצע אימות באמצעות חשבון GitHub שלכם. פועלים לפי הוראות ליצירת GitHub אסימון הגישה האישית כדי להמשיך בתהליך.
5. בחלון הבא, בוחרים באפשרות הרדיו Version ואז בוחרים Up to Next Major Version. מהרשימה הנפתחת, ולהזין את הגרסה האחרונה של Maps SDK for iOS Utility Library (לדוגמה, '6.0.0').
6. לוחצים על התפריט הנפתח לצד Add to Project (הוספה לפרויקט), בוחרים את הפרויקט ולוחצים על Add Package (הוספת חבילה).

שימוש ב-CocoaPods

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

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

1. הורדה הארכיון של דוגמת הקוד GitHub ופורקים את הארכיון.
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 באמצעות Cocoapods:

   pod try Google-Maps-iOS-Utils

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

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 = @"";