دریافت Driver SDK

gcloud

gcloud auth login

CocoaPods

1. ابزار CocoaPods را نصب کنید: یک پنجره ترمینال باز کنید و دستور زیر را اجرا کنید.

   sudo gem install cocoapods
   

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

2. ایجاد Podfile برای Driver SDK: از Podfile برای نصب API و وابستگی‌های آن استفاده می‌کنید.

   1. فایلی با نام Podfile در فهرست راهنمای پروژه‌تان ایجاد کنید. این فایل وابستگی‌های پروژه شما را تعریف می‌کند.

   2. Podfile را ویرایش کنید و وابستگی‌هایتان را اضافه کنید. در اینجا مثالی آورده شده است که شامل وابستگی‌ها است:

      source "https://github.com/CocoaPods/Specs.git"
      
      target 'YOUR_APPLICATION_TARGET_NAME_HERE' do
        pod 'GoogleRidesharingDriver'
      end
      

      در اینجا مثالی آورده شده است که شامل پادهای آلفا و بتا برای کیت توسعه نرم‌افزار راننده به‌عنوان وابستگی‌ها است:

      source "https://cpdc-eap.googlesource.com/ridesharing-driver-sdk.git"
      source "https://github.com/CocoaPods/Specs.git"
      
      target 'YOUR_APPLICATION_TARGET_NAME_HERE' do
        pod 'GoogleRidesharingDriver'
      end
      

   3. Podfile را ذخیره کنید: پایانه‌ای را باز کنید و به پوشه حاوی Podfile بروید:

      cd <path-to-project>
      

3. فرمان pod install را اجرا کنید: این فرمان میاناهای برنامه‌سازی کاربردی مشخص‌شده در Podfile را به‌همراه وابستگی‌هایی که ممکن است داشته باشند نصب می‌کند.

   pod install
   

4. پروژه خود را در Xcode باز کنید: Xcode را ببندید و سپس فایل .xcworkspace پروژه خود را باز کنید (دوبار کلیک کنید) تا Xcode راه‌اندازی شود. برای باز کردن پروژه در آینده، از فایل xcworkspace .استفاده کنید.

Swift Package Manager

«کیت توسعه نرم‌افزار راننده» را می‌توان ازطریق مدیر بسته Swift نصب کرد. برای افزودن کیت توسعه نرم‌افزار، مطمئن شوید که هرگونه وابستگی موجود Driver SDK را برداشته‌اید.

برای افزودن SDK به پروژه جدید یا موجود، این مراحل را دنبال کنید:

1. ‫Xcode project یا workspace را باز کنید، سپس به File > Add Package Dependencies بروید.
2. https://github.com/googlemaps/ios-driver-sdk را به‌عنوان نشانی وب وارد کنید، Enter را فشار دهید تا بسته را وارد کنید، و روی «افزودن بسته» کلیک کنید.
3. برای نصب version خاص، فیلد قانون وابستگی را روی یکی از گزینه‌های مبتنی بر نسخه تنظیم کنید. برای پروژه‌های جدید، توصیه می‌کنیم جدیدترین نسخه را مشخص کنید و از گزینه «نسخه دقیق» استفاده کنید. پس‌از تکمیل، روی «افزودن بسته» کلیک کنید.
4. در پنجره انتخاب محصولات بسته، تأیید کنید که GoogleRidesharingDriver به هدف main تعیین‌شده شما اضافه خواهد شد. پس‌از تکمیل، روی «افزودن بسته» کلیک کنید.
5. برای درستی‌سنجی نصب، به قاب General (عمومی) هدف بروید. در Frameworks, Libraries, and Embedded Content باید بسته‌های نصب‌شده را ببینید. همچنین می‌توانید بخش «وابستگی‌های بسته» را در «Project Navigator» مشاهده کنید تا بسته و نسخه آن را تأیید کنید.

برای به‌روزرسانی package برای پروژه موجود، این مراحل را دنبال کنید:

1. از Xcode، به فایل > بسته‌ها > به‌روزرسانی به جدیدترین نسخه‌های بسته بروید.
2. برای درستی‌سنجی نصب، به بخش وابستگی‌های بسته در Project Navigator بروید تا بسته و نسخه آن را درستی‌سنجی کنید.

برای برداشتن Driver SDK موجود که به‌صورت دستی نصب شده است، این مراحل را دنبال کنید:

1. از تنظیمات پیکربندی پروژه Xcode، چارچوب‌ها، کتابخانه‌ها، و محتوای جاسازی‌شده را پیدا کنید. از علامت منفی(-) برای برداشتن چارچوب زیر استفاده کنید:

   • GoogleRidesharingDriver.xcframework

2. از دایرکتوری سطح بالای پروژه Xcode، بسته GoogleRidesharingDriver را بردارید.

نصب دستی

این راهنما نشان می‌دهد که چگونه به‌صورت دستی XCFramework حاوی Driver SDK را به پروژه‌تان اضافه کنید و تنظیمات ساخت را در Xcode پیکربندی کنید.

قبل‌از دنبال کردن این راهنما، کارهای زیر را انجام دهید:

• XCFramework را بارگیری کنید، یک بسته دودویی که برای نصب Driver SDK استفاده می‌کنید. می‌توانید از این بسته در چندین پلاتفرم استفاده کنید، ازجمله دستگاه‌هایی که از Apple silicon استفاده می‌کنند

• کیت توسعه نرم‌افزار پیمایش را نصب کنید.

مراحل زیر را برای نصب دستی Driver SDK انجام دهید:

1. بارگیری منابع و دودویی کیت توسعه نرم‌افزار:

   • GoogleRidesharingDriver.xcframework
   • GoogleRidesharingDriver.bundle

2. فایل‌های فشرده‌شده را از حالت فشرده خارج کنید تا به XCFramework و منابع دسترسی پیدا کنید.

3. Xcode را راه‌اندازی کنید و پروژه موجودی را باز کنید یا پروژه جدیدی ایجاد کنید. اگر تازه با iOS آشنا شده‌اید، پروژه جدیدی ایجاد کنید و الگوی «برنامه iOS» را انتخاب کنید.

4. اگر گروه پروژه شما حاوی گروه Frameworks نیست، آن را ایجاد کنید.

5. برای نصب Driver SDK، فایل GoogleRidesharingDriver.xcframework را به پروژه خودتان در بخش چارچوب‌ها، کتابخانه‌ها، و محتوای جاسازی‌شده بکشید. اگر درخواست شد، کپی کردن موارد را انتخاب کنید.

6. GoogleRidesharingDriver.bundle بارگیری‌شده را به دایرکتوری سطح بالای پروژه Xcode بکشید. اگر خواسته شد، کپی کردن موارد را انتخاب کنید.

7. پروژه‌تان را از Project Navigator انتخاب کنید و هدف برنامه‌تان را انتخاب کنید.

8. برگه Build Phases را باز کنید و در Link Binary with Libraries، چارچوب‌ها و کتابخانه‌های زیر را اگر ازقبل وجود ندارند اضافه کنید:

   • Accelerate.framework
   • AudioToolbox.framework
   • AVFoundation.framework
   • CoreData.framework
   • CoreGraphics.framework
   • CoreLocation.framework
   • CoreTelephony.framework
   • CoreText.framework
   • GLKit.framework
   • ImageIO.framework
   • libc++.tbd
   • libxml2.tbd
   • libz.tbd
   • LocalAuthentication.framework
   • OpenGLES.framework
   • QuartzCore.framework
   • SystemConfiguration.framework
   • UIKit.framework
   • WebKit.framework

9. پروژه‌تان را به‌جای هدف خاصی انتخاب کنید و برگه تنظیمات ساخت را باز کنید. در بخش Other Linker Flags،‏ -ObjC را برای هر دو حالت اشکال‌زدایی و انتشار اضافه کنید.

   اگر این تنظیمات قابل‌مشاهده نیستند، فیلتر را در نوار Build Settings (تنظیمات ساخت) از Basic (پایه) به All (همه) تغییر دهید.