دریافت Driver SDK

این بخش نحوه تأیید اینکه سیستم شما حداقل الزامات را برآورده می‌کند، راه‌اندازی گروه Workspace شما و دریافت Driver SDK را شرح می‌دهد.

قبل‌از شروع

«کیت توسعه نرم‌افزار راننده» برای iOS نیاز دارد که برنامه شما معیارهای زیر را داشته باشد:

• کیت توسعه نرم‌افزار پیمایش را داشته باشید.
• «کیت توسعه نرم‌افزار Google Maps برای iOS» را در «کنسول Google Cloud» فعال کنید و کلید API دریافت کنید.

بررسی حداقل ملزومات سیستم

برای اطلاع از حداقل الزامات نسخه Driver SDK که استفاده می‌کنید، یادداشت‌های انتشار را بررسی کنید. یادداشت‌های انتشار را ببینید.

• دستگاه همراه باید iOS 16 یا نسخه‌های جدیدتر را اجرا کند.
• ‫Apple Xcode نسخه ۲۶ یا جدیدتر.

دسترسی به Google Workspace

اگر مشتری Google Workspace هستید، مراحل زیر را انجام دهید:

1. «گروه Workspace» ایجاد کنید. برای اطلاعات بیشتر، گروه Workspace را ببینید.

   برای مثال، به‌عنوان یک روال مطلوب، گروهتان را [e-mail] درطول آماده‌سازی نام‌گذاری کنید.

2. نام را به Google ارائه دهید تا «گروه Workspace» شما را به فهرست مجاز اضافه کند که دسترسی به مخازن صحیح CocoaPods را اعطا می‌کند.

3. تأیید کنید که ایمیل‌های کاربر و ایمیل‌های حساب خدمات که نیاز به دسترسی دارند در این فهرست گنجانده شده‌اند.

اگر سازمانتان نمی‌تواند «گروه‌های Workspace» ایجاد کند، فهرستی از ایمیل‌های حساب کاربری و حساب سرویس را که به دسترسی به این مصنوعات نیاز دارند برای Google ارسال کنید.

توجه: «گروه‌های Workspace» با «گروه‌های Google» که به @googlegroups.com ختم می‌شوند یکسان نیستند. فقط از «گروه‌های Workspace» پشتیبانی می‌شود.

ورود به سیستم با Cloud SDK

برای توسعه محلی، با Cloud SDK به سیستم وارد شوید. برای جزئیات، نصب میانای خط فرمان gcloud را ببینید.

مثال‌های زیر نحوه ورود به سیستم با Cloud SDK را نشان می‌دهد.

gcloud

gcloud auth login

باید از ایمیلی استفاده کنید که عضو «گروه Workspace» باشد.

راه‌اندازی میزبان‌های خودکارسازی

برای سیستم‌های ساخت یا ادغام مداوم، میزبان‌های خودکارسازی‌تان را براساس فهرست روش‌های ارائه‌شده برای استفاده از حساب سرویس جهت اصالت‌سنجی در سرویس‌ها و میاناهای برنامه‌سازی کاربردی Google راه‌اندازی کنید. برای جزئیات، به بخش حساب سرویس در صفحه «روش‌های اصالت‌سنجی در Google» مراجعه کنید.

• اگر فرایند شما در محیط Google Cloud اجرا می‌شود، از تشخیص خودکار اطلاعات اعتباری استفاده کنید. برای اطلاعات بیشتر، تشخیص خودکار اطلاعات اعتباری را ببینید.

• درغیراین‌صورت، فایل کلید حساب سرویس را در مکان امنی در سیستم فایل میزبان ذخیره کنید و متغیر محیطی GOOGLE_APPLICATION_CREDENTIALS را به‌طور مناسب تنظیم کنید. برای جزئیات بیشتر، GOOGLE_APPLICATION_CREDENTIALS را ببینید.

ایمیل حساب سرویس منسوب به اطلاعات اعتباری باید عضو «گروه Workspace» باشد.

دریافت کیت توسعه نرم‌افزار درایور

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

CocoaPods

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

   sudo gem install cocoapods
   

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

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

   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: این فرمان میاناهای برنامه‌سازی کاربردی مشخص‌شده در Podfile را به‌همراه هرگونه وابستگی که ممکن است داشته باشند نصب می‌کند.

   pod install
   

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

   توجه: pod outdated را به‌طور دوره‌ای اجرا کنید تا متوجه شوید چه زمانی نسخه جدیدتری از کیت توسعه نرم‌افزار دردسترس است. برای اطلاعات بیشتر، نسخه‌های کیت توسعه نرم‌افزار راننده برای iOS را ببینید.

مدیر بسته Swift

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

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

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

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

1. از Xcode، به File > Packages > Update To Latest Package Versions بروید.
2. برای درستی‌سنجی نصب، به بخش وابستگی‌های بسته در پیمایشگر پروژه بروید تا بسته و نسخه آن را درستی‌سنجی کنید.

مهم: گاهی اوقات، آرتیفکت‌ها قابل‌حل نیستند یا ممکن است خطا رخ دهد، در این صورت «فایل > بسته‌ها > بازنشانی حافظه نهان بسته» را انتخاب کنید.

برای برداشتن «کیت توسعه نرم‌افزار» نصب‌شده به‌صورت دستی، این مراحل را دنبال کنید:

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

   • GoogleRidesharingDriver.xcframework

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

نصب دستی

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

احتیاط: به‌عنوان یک روال مطلوب، درصورت امکان از Cocoapods برای نصب «کیت توسعه نرم‌افزار راننده» استفاده کنید.

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

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

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

برای نصب دستی «کیت توسعه نرم‌افزار درایور»، مراحل زیر را انجام دهید:

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

   • GoogleRidesharingDriver.xcframework
   • GoogleRidesharingDriver.bundle

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

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

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

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

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

7. پروژه‌تان را از «پیمایشگر پروژه» انتخاب کنید و هدف برنامه‌تان را انتخاب کنید.

8. زبانه ساخت مراحل را باز کنید و در پیوند باینری با کتابخانه‌ها، چارچوب‌ها و کتابخانه‌های زیر را اضافه کنید (اگر ازقبل وجود ندارند):

   • 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. پروژه‌تان را به‌جای هدف خاصی انتخاب کنید و زبانه تنظیمات ساخت را باز کنید. در بخش پرچم‌های پیونددهنده دیگر، -ObjC را برای هر دو اشکال‌زدایی و انتشار اضافه کنید.

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

بررسی فایل مانیفست حریم خصوصی Apple

‫Apple جزئیات حریم خصوصی برنامه را برای برنامه‌های موجود در App Store الزامی کرده است. برای به‌روزرسانی‌ها و اطلاعات بیشتر، از صفحه جزئیات حریم خصوصی Apple App Store بازدید کنید.

فایل «مانیفست حریم خصوصی Apple» در دسته منابع کیت توسعه نرم‌افزار گنجانده شده است. برای تأیید اینکه «فایل مانیفست حریم خصوصی» اضافه شده است و برای بررسی محتوای آن، بایگانی‌ای از برنامه‌تان ایجاد کنید و از بایگانی گزارش حریم خصوصی تولید کنید.

قدم بعدی چیست

پیکربندی پروژه کنسول Google Cloud