בדף הזה מוסבר איך מגדירים את ספריית התשתיות ל-SDK של מפות Google ל-iOS.
כדי לנסות את הכלים האלה, אפשר:
- התקנה והפעלה של אפליקציית ההדגמה. אפליקציית ההדגמה היא פרויקט עצמאי שמכיל את כל הקוד שנדרש כדי לנסות את הכלים השונים.
- מתקינים את ספריית כלי העזר בפרויקט Xcode קיים. כדאי להוסיף את הכלים האלה לפרויקט שלכם.
אפשר גם להתקין את CocoaPods
ספריית כלי העזר זמינה כ-pod של CocoaPods בשם
Google-Maps-iOS-Utils
. CocoaPods היא מנהלת יחסי תלות של קוד פתוח בפרויקטים של Swift ו-Objective-C Cocoa.
אם הכלי CocoaPods עדיין לא מותקן, מריצים את הפקודה הבאה מהטרמינל כדי להתקין אותו ב-macOS:
sudo gem install cocoapods
פרטים נוספים זמינים במדריך לתחילת העבודה של CocoaPods.
התקנה והפעלה של אפליקציית ההדגמה
ספריית כלי השירות כוללת אפליקציית הדגמה שניתן להתקין ולאחר מכן לנסות כל כלי עזר.
מתקינים את אפליקציית ההדגמה באחת משתי השיטות הבאות:שימוש בקבצים מ-GitHub
- מורידים את הארכיון של דוגמת הקוד מ-GitHub ופורקים את הארכיון.
- פותחים חלון טרמינל, עוברים לספרייה שבה הרחבתם את הקבצים לדוגמה ומציגים פירוט של ספריית הדוגמאות המתאימה לשפה שבה רוצים להשתמש:
- עבור Swift, יש להריץ
cd google-maps-ios-utils-master/samples/SwiftDemoApp
- עבור יעד-C, מריצים את
cd google-maps-ios-utils-master/samples/ObjCDemoApp
- עבור Swift, יש להריץ
- מריצים את הפקודה הבאה:
pod install
- סוגרים את Xcode ופותחים (לוחצים לחיצה כפולה) את הקובץ
.xcworkspace
של הפרויקט כדי להפעיל את Xcode. מרגע זה ואילך צריך להשתמש בקובץ.xcworkspace
כדי לפתוח את הפרויקט.
שימוש ב-CocoaPods v1.6.1
- פותחים חלון טרמינל ומתקינים את גרסה 1.6.1:
sudo gem install cocoapods -v1.6.1
- מאחזרים את הקבצים של מפות 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
באופן הבא:
- מוסיפים את הצהרת הייבוא הבאה:
import GoogleMaps
- עורכים את השורה הבאה כדי להוסיף את מפתח ה-API בין המירכאות הכפולות:
// Change this key to a valid key registered with the demo app bundle id. let mapsAPIKey = ""
Objective-C
מוסיפים את מפתח ה-API ל-AppDelegate.m
באופן הבא:
- מוסיפים את הצהרת הייבוא הבאה:
@import GoogleMaps;
- עורכים את השורה הבאה כדי להוסיף את מפתח ה-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
- אם עדיין אין לך פרויקט ב-Xcode, צריך ליצור פרויקט עכשיו ולשמור אותו במחשב המקומי. (אם אתם מפתחים חדשים ל-iOS, צרו אפליקציה עם תצוגה יחידה.)
- אם עדיין אין לפרויקט קובץ pod, צריך ליצור קובץ בשם
Podfile
בספריית הפרויקט. הקובץ הזה מגדיר את יחסי התלות של הפרויקט שלכם. - עורכים את קובץ ה-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
- מריצים את
pod install
. - סוגרים את Xcode ופותחים (לוחצים לחיצה כפולה) את הקובץ
.xcworkspace
של הפרויקט כדי להפעיל את Xcode. מרגע זה ואילך צריך להשתמש בקובץ.xcworkspace
כדי לפתוח את הפרויקט.
הערה: הכלי לקיבוץ סמנים תלוי בריבוע, אבל אפשר להשתמש במקבץ סמנים ללא קיבוץ סמנים. אם רוצים רק את הכלי quadtree, אפשר לשנות את הערך של pod 'Google-Maps-iOS-Utils'
ל-'Google-Maps-iOS-Utils/QuadTree'
בקובץ ה-pod.
שימוש ב-Carthage
- התקן את Carthage. יש כמה שיטות, ולכן כדאי לעיין בקובץ ה-README של Carthage כדי לראות את השלבים המדויקים.
- אם עדיין אין לך פרויקט ב-Xcode, צריך ליצור פרויקט עכשיו ולשמור אותו במחשב המקומי. (אם אתם מתחילים את הפיתוח ל-iOS, צרו פרויקט חדש ובחרו את תבנית האפליקציה ל-iOS. ב-Xcode 11.7 או בגרסאות קודמות, יוצרים אפליקציית 'תצוגה יחידה'.)
- יוצרים קובץ בשם
Cartfile
בספריית הפרויקט. הקובץ הזה מגדיר את יחסי התלות של הפרויקט שלכם. - עורכים את ה-
Cartfile
ומוסיפים את ה-SDK של מפות Google לספריות תשתיות של iOS:
github "googlemaps/google-maps-ios-utils"
- שומרים את
Cartfile
. - בחלון הטרמינל, עוברים לספרייה שמכילה את
Cartfile
:
cd <path-to-project>
- מריצים את פקודת העדכון:
carthage update --platform iOS
הפעולה הזו תתקין את ממשקי ה-API שצוינו ב-Cartfile
, יחד עם כל יחסי התלות שלהם. - ב-Finder, בספריית הפרויקט, נכנסים לקובצי ה-framework שהורדתם בקטע
Carthage/Build/iOS
. - כדי להוסיף לפרויקט את ה-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
- לוחצים לחיצה ימנית על
GoogleMaps.framework
בפרויקט ובוחרים באפשרות Show In Finder. - גוררים את השדה
Carthage/Build/iOS/GoogleMaps.framework/Resources/GoogleMaps.bundle
מהתיקייהResources
לפרויקט. כשמוצגת הבקשה, מוודאים שהאפשרות העתקת פריטים לתיקייה של קבוצת היעד לא מסומנת. - בוחרים את הפרויקט מתוך Project Navigator, ובוחרים את יעד האפליקציה.
- פותחים את הכרטיסייה 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
בוחרים את הפרויקט ולא ביעד ספציפי, ופותחים את הכרטיסייה Build Settings (הגדרות build). בקטע Other Links flags מוסיפים את
-ObjC
. אם ההגדרות האלה לא מוצגות, משנים את המסנן בסרגל Build Settings (הגדרות Build) מ-Basic (בסיסי) ל-All (הכול).
שימוש במנהל החבילות של Swift
- אם עדיין אין לכם פרויקט ב-Xcode, צריך ליצור פרויקט עכשיו ולשמור אותו במחשב המקומי. (אם זו הפעם הראשונה שאתם עובדים על פיתוח ל-iOS, תוכלו ליצור פרויקט חדש ולבחור את תבנית האפליקציה ל-iOS. ב-Xcode מגרסה 11.7 ואילך, יוצרים אפליקציה לתצוגה יחידה.)
- הוסף את ה-SDK של מפות Google ל-iOS כתלוי. האפשרויות מפורטות במאמר התקנת ה-SDK.
- בפרויקט Xcode, עוברים אל File -> Swift Packages -> Add Package Dependency.
- בחלון שמוצג, מזינים את ה-SDK של מפות Google למאגר המאגר של ספריית הכלים ל-iOS
https://github.com/googlemaps/google-maps-ios-utils
ובוחרים באפשרות Next. - בשלב הזה ייתכן שתתבקשו לבצע אימות באמצעות חשבון GitHub שלכם. פועלים לפי ההוראות כדי ליצור אסימון גישה אישי של GitHub כדי להמשיך בתהליך.
- בחלון הבא, בוחרים באפשרות הרדיו Version, בוחרים באפשרות Exact מהרשימה הנפתחת, מזינים את הגרסה האחרונה של Maps SDK עבור iOS Utility Library (למשל "3.4.0") ובוחרים באפשרות Next.
הוספה של מפתח ה-API לאפליקציה
במאמר הגדרת פרויקט Xcode מפורטות הוראות ליצירת מפתח API ולהוספה שלו לפרויקט Xcode.יצירה והפעלה של הפרויקט
אחרי שמוסיפים את מפתח ה-API, צריך ליצור ולהפעיל את הפרויקט.
הוספת כלי עזר לאפליקציה
במסמכי התיעוד של כל כלי אפשר לקרוא מידע נוסף על השימוש בו באפליקציה: