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

پلاتفرم را انتخاب کنید: Android iOS JavaScript

برای دنبال کردن سفرهای درخواستی در برنامه‌های مصرف‌کننده iOS، از Consumer SDK استفاده کنید. برای اطلاعات بیشتر و مقدمه‌ای بر دنبال کردن سفرها، به دنبال کردن سفر در iOS مراجعه کنید.

برای مثال، برنامه‌های نمونه iOS یا نمونه‌های ترکیبی را ببینید.

برای راه‌اندازی Consumer SDK برای برنامه مصرف‌کننده iOS، این مراحل را دنبال کنید:

1. حداقل ملزومات سیستم را بررسی کنید.
2. دریافت کیت توسعه نرم‌افزار مصرف‌کننده.
3. فایل Apple Privacy Manifest را بررسی کنید.
4. پیکربندی پروژه «کنسول Google Cloud».
5. دریافت کدهای اصالت‌سنجی.
6. مقداردهی اولیه Consumer SDK.

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

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

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

دریافت Consumer SDK

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

Swift Package Manager

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

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

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

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

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

مهم: گاهی‌اوقات، مصنوعات حل‌وفصل نمی‌شوند یا ممکن است خطاهایی رخ دهد، در این صورت «File > Packages > Reset Package Cache» (فایل > بسته‌ها> بازنشانی حافظه نهان بسته) را انتخاب کنید.

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

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

   • GoogleRidesharingConsumer.xcframework

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

استفاده از CocoaPods

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

   sudo gem install cocoapods
   

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

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

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

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

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

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

      cd <path-to-project>
      

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

   pod install
   

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

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

نصب دستی

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

احتیاط: به‌عنوان روال مطلوب، هرگاه امکان‌پذیر بود از Cocoapods برای نصب Consumer SDK استفاده کنید.

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

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

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

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

   • GoogleRidesharingConsumer.xcframework
   • GoogleRidesharingConsumer.bundle
   • gRPCCertificates.bundle

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

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

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

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

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

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

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

9. برگه Build Phases را باز کنید و در Link 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
   • Metal.framework
   • OpenGLES.framework
   • QuartzCore.framework
   • SystemConfiguration.framework
   • UIKit.framework

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

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

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

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

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

قدم بعدی چیست

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