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

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

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

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

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

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

1. از Xcode، به "File > Packages > Update To Latest Package Versions" بروید.
2. برای تأیید نصب خود، به بخش Package Dependencies در Project Navigator بروید تا بسته و نسخه آن را تأیید کنید.

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

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

   • 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 بروید:

      cd <path-to-project>
      

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

   pod install
   

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

نصب دستی

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

1. از Xcode، به "File > Packages > Update To Latest Package Versions" بروید.
2. برای تأیید نصب خود، به بخش Package Dependencies در Project Navigator بروید تا بسته و نسخه آن را تأیید کنید.

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

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

   • 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 بروید:

      cd <path-to-project>
      

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

   pod install
   

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

نصب دستی

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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