Driver SDK را دریافت کنید

جی‌کلاود

gcloud auth login

کوکوپادز

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

   sudo gem install cocoapods
   

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

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

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

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

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

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

      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. ذخیره فایل پادفایل : یک ترمینال باز کنید و به پوشه حاوی فایل پادفایل بروید:

      cd <path-to-project>
      

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

   pod install
   

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

مدیر بسته سوئیفت

درایور SDK را می‌توان از طریق Swift Package Manager نصب کرد. برای افزودن SDK، مطمئن شوید که هرگونه وابستگی درایور SDK موجود را حذف کرده‌اید.

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

1. project یا workspace Xcode خود را باز کنید، سپس به File > Add Package Dependencies بروید.
2. آدرس https://github.com/googlemaps/ios-driver-sdk را به عنوان URL وارد کنید، Enter را بزنید تا بسته را دریافت کنید و روی «افزودن بسته» کلیک کنید.
3. برای نصب یک version خاص، فیلد Dependency Rule را روی یکی از گزینه‌های مبتنی بر نسخه تنظیم کنید. برای پروژه‌های جدید، توصیه می‌کنیم آخرین نسخه را مشخص کرده و از گزینه "Exact Version" استفاده کنید. پس از تکمیل، روی "Add Package" کلیک کنید.

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

1. برای تأیید نصب خود، به بخش وابستگی‌های بسته‌بندی در Project Navigator بروید تا بسته و نسخه آن را تأیید کنید.

برای حذف دستی درایور SDK موجود، مراحل زیر را دنبال کنید:

1. از تنظیمات پیکربندی پروژه Xcode خود، Frameworks، Libraries و Embedded Content را پیدا کنید. از علامت منها (-) برای حذف framework زیر استفاده کنید:

   • GoogleRidesharingDriver.xcframework

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

نصب دستی

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

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

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

• کیت توسعه نرم‌افزار ناوبری (Navigation SDK) را نصب کنید.

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

1. دانلود فایل باینری و منابع SDK:

   • درایور اشتراک‌گذاری گوگل (GoogleRidesharingDriver.xcframework)
   • بسته درایور اشتراک‌گذاری گوگل (GoogleRidesharingDriver.bundle)

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

3. Xcode را اجرا کنید و یک پروژه موجود را باز کنید یا یک پروژه جدید ایجاد کنید. اگر در iOS تازه‌کار هستید، یک پروژه جدید ایجاد کنید و قالب iOS App را انتخاب کنید.

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

5. برای نصب درایور SDK، فایل GoogleRidesharingDriver.xcframework را در قسمت Frameworks، Libraries و Embedded Content به پروژه خود بکشید و رها کنید. در صورت درخواست، گزینه Copy items را انتخاب کنید.

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

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. به جای یک هدف خاص، پروژه خود را انتخاب کنید و تب Build Settings را باز کنید. در بخش Other Linker Flags ، برای اشکال‌زدایی و انتشار، -ObjC را اضافه کنید.

   اگر این تنظیمات قابل مشاهده نیستند، فیلتر موجود در نوار تنظیمات ساخت را از Basic به All تغییر دهید.