iOS Consumer SDK را دریافت کنید

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

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

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

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

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

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

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

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

   • GoogleRidesharingConsumer.xcframework

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

از کوکو پادز استفاده کنید

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

   sudo gem install cocoapods
   

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

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

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

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

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

   3. ذخیره فایل پادفایل : یک ترمینال باز کنید و به پوشه حاوی فایل پادفایل بروید:

      cd <path-to-project>
      

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

   pod install
   

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

نصب دستی

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

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

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

• SDK نقشه‌ها را نصب کنید.

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

   • چارچوب اشتراک‌گذاری سواری گوگل (GoogleRidesharingConsumer.xcframework)
   • بسته نرم‌افزاری GoogleRidesharingConsumer
   • gRPCCertificates.bundle

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

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

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

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

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

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

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

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