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

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

قبل از شروع

Driver SDK برای iOS به برنامه شما نیاز دارد که معیارهای زیر را داشته باشد:

  • Navigation SDK را داشته باشید.
  • Maps SDK برای iOS را در Google Cloud Console خود فعال کنید و یک کلید API دریافت کنید.

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

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

  • دستگاه تلفن همراه باید دارای iOS 14 یا جدیدتر باشد.
  • Apple Xcode نسخه 15 یا بالاتر.

به Google Workspace خود دسترسی پیدا کنید

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

  1. یک گروه فضای کاری ایجاد کنید. برای اطلاعات بیشتر، گروه فضای کاری را ببینید.

    برای مثال، به عنوان بهترین روش، نام گروه خود را google-maps-platform-sdk-users@workspacedomain.com در حین ورود نام ببرید.

  2. نامی را در اختیار Google قرار دهید تا Workspace Group خود را به لیستی از مجوزها اضافه کند که به مخازن صحیح CocoaPods دسترسی می‌دهد.

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

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

با Cloud SDK وارد شوید

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

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

gcloud 

gcloud auth login

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

هاست های اتوماسیون خود را تنظیم کنید

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

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

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

ایمیل حساب سرویس مرتبط با اطلاعات کاربری باید عضوی از Workspace Group باشد.

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

Driver SDK را نصب و پیکربندی کنید.

CocoaPods

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

    sudo gem install cocoapods

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

  2. ایجاد یک پادفایل برای 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

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

      cd <path-to-project>

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

    pod install

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

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

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

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

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

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

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

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

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

    • GoogleRidesharingDriver.xcframework

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

نصب دستی

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

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

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

  • Navigation SDK را نصب کنید.

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

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

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

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

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

  5. برای نصب Driver SDK، فایل GoogleRidesharingDriver.xcframework را به داخل پروژه خود در بخش Frameworks, Libraries, and Embedded Content بکشید. در صورت درخواست، کپی موارد را انتخاب کنید.

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

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

  8. تب Build Phases را باز کنید و در پیوند باینری با کتابخانه ها ، فریم ورک ها و کتابخانه های زیر را در صورتی که از قبل موجود نیستند اضافه کنید:

    • 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 تغییر دهید.

فایل Manifest Privacy Apple را بررسی کنید

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

فایل Apple Privacy Manifest در بسته منابع برای SDK گنجانده شده است. برای تأیید اینکه فایل Manifest Privacy گنجانده شده است و برای بررسی محتوای آن، یک بایگانی از برنامه خود ایجاد کنید و یک گزارش حریم خصوصی از بایگانی ایجاد کنید .

بعدش چی

یک پروژه Google Cloud Console را پیکربندی کنید

،

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

قبل از شروع

Driver SDK برای iOS به برنامه شما نیاز دارد که معیارهای زیر را داشته باشد:

  • Navigation SDK را داشته باشید.
  • Maps SDK برای iOS را در Google Cloud Console خود فعال کنید و یک کلید API دریافت کنید.

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

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

  • دستگاه تلفن همراه باید دارای iOS 14 یا جدیدتر باشد.
  • Apple Xcode نسخه 15 یا بالاتر.

به Google Workspace خود دسترسی پیدا کنید

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

  1. یک گروه فضای کاری ایجاد کنید. برای اطلاعات بیشتر، گروه فضای کاری را ببینید.

    برای مثال، به عنوان بهترین روش، نام گروه خود را google-maps-platform-sdk-users@workspacedomain.com در حین ورود نام ببرید.

  2. نامی را در اختیار Google قرار دهید تا Workspace Group خود را به لیستی از مجوزها اضافه کند که به مخازن صحیح CocoaPods دسترسی می‌دهد.

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

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

با Cloud SDK وارد شوید

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

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

gcloud 

gcloud auth login

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

هاست های اتوماسیون خود را تنظیم کنید

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

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

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

ایمیل حساب سرویس مرتبط با اطلاعات کاربری باید عضوی از Workspace Group باشد.

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

Driver SDK را نصب و پیکربندی کنید.

CocoaPods

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

    sudo gem install cocoapods

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

  2. ایجاد یک پادفایل برای 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

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

      cd <path-to-project>

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

    pod install

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

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

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

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

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

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

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

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

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

    • GoogleRidesharingDriver.xcframework

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

نصب دستی

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

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

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

  • Navigation SDK را نصب کنید.

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

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

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

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

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

  5. برای نصب Driver SDK، فایل GoogleRidesharingDriver.xcframework را به داخل پروژه خود در بخش Frameworks, Libraries, and Embedded Content بکشید. در صورت درخواست، کپی موارد را انتخاب کنید.

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

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

  8. تب Build Phases را باز کنید و در پیوند باینری با کتابخانه ها ، فریم ورک ها و کتابخانه های زیر را در صورتی که از قبل موجود نیستند اضافه کنید:

    • 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 تغییر دهید.

فایل Manifest Privacy Apple را بررسی کنید

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

فایل Apple Privacy Manifest در بسته منابع برای SDK گنجانده شده است. برای تأیید اینکه فایل Manifest Privacy گنجانده شده است و برای بررسی محتوای آن، یک بایگانی از برنامه خود ایجاد کنید و یک گزارش حریم خصوصی از بایگانی ایجاد کنید .

بعدش چی

یک پروژه Google Cloud Console را پیکربندی کنید