این سند نحوه شروع توسعه با API پیامهای نزدیک در iOS را توضیح میدهد.
مرحله ۱: آخرین نسخه Xcode را دریافت کنید
برای ساخت یک پروژه با استفاده از API پیامهای نزدیک گوگل برای iOS، به نسخه ۶.۳ یا بالاتر Xcode نیاز دارید.
مرحله ۲: CocoaPods را تهیه کنید
رابط برنامهنویسی کاربردی (API) پیامهای نزدیک گوگل برای iOS به عنوان یک پاد CocoaPods در دسترس است. CocoaPods یک ابزار مدیریت وابستگی متنباز برای پروژههای Swift و Objective-C Cocoa است.
اگر ابزار CocoaPods را از قبل ندارید، با اجرای دستور زیر از ترمینال، آن را روی OS X نصب کنید. برای جزئیات بیشتر، به راهنمای شروع به کار با CocoaPods مراجعه کنید.
$ sudo gem install cocoapods
مرحله ۳: نصب API با استفاده از CocoaPods
یک Podfile برای API پیامهای نزدیک گوگل برای iOS ایجاد کنید و از آن برای نصب API و وابستگیهای آن استفاده کنید.
- اگر هنوز پروژه Xcode ندارید، اکنون یکی ایجاد کنید و آن را در دستگاه محلی خود ذخیره کنید. (اگر در توسعه iOS تازه کار هستید، یک برنامه تک نمایی ایجاد کنید و مطمئن شوید که گزینه «استفاده از شمارش مرجع خودکار» روشن است.)
- فایلی با نام
Podfileدر دایرکتوری پروژه خود ایجاد کنید. این فایل وابستگیهای پروژه شما را تعریف میکند. Podfileویرایش کنید و وابستگیهای خود را اضافه کنید. در اینجا یک Podspec ساده، شامل نام pod مورد نیاز برای API پیامهای نزدیک گوگل برای iOS، آورده شده است:source 'https://github.com/CocoaPods/Specs.git' platform :ios, '7.0' pod 'NearbyMessages'
Podfileرا ذخیره کنید.یک ترمینال باز کنید و به دایرکتوری حاوی
Podfileبروید:سی دی دلار
دستور
pod installرا اجرا کنید. این دستور API های مشخص شده در Podspec را به همراه هرگونه وابستگی که ممکن است داشته باشند، نصب خواهد کرد.نصب غلاف $
Xcode را ببندید و سپس فایل
.xcworkspaceپروژه خود را باز کنید (روی آن دوبار کلیک کنید). از این به بعد، برای باز کردن پروژه باید از فایل.xcworkspaceاستفاده کنید.
مرحله ۴: ایجاد یک هدر پلساز (فقط سوئیفت)
اگر پروژه خود را با استفاده از Swift ایجاد کردهاید، باید یک هدر پل به پروژه خود اضافه کنید تا بتواند از کتابخانههایی که توسط فایل pod نصب شدهاند استفاده کند. برای اضافه کردن یک هدر پل، این مراحل را دنبال کنید:
- در همان دایرکتوری که فایل
.xcworkspaceپروژه شما قرار دارد، یک فایل هدر جدید اضافه کنید (نام آن را هر چه دوست دارید بگذارید و از پسوند ".h" استفاده کنید). - کد زیر را در فایلی که ایجاد کردهاید، جایگذاری کنید:
#import <GNSMessages.h>. - فایل را ذخیره کنید.
- در پنل سمت چپ ویرایشگر پروژه، پروژه اصلی را انتخاب کنید.
- روی «تنظیمات ساخت» در بالای ویرایشگر ساخت کلیک کنید.
- در تنظیمات ساخت (Build Settings)، به «کامپایلر سویفت - تولید کد» (Swift Compiler - Code Generation) بروید (برای یافتن سریع آن، «کامپایلر سویفت» را در کادر جستجو تایپ کنید).
- برای باز کردن بخش Bridge Header زبان Objective-C، روی فلش کلیک کنید.
- در قسمت Debug and Release ، مسیر فایل هدری که ایجاد کردهاید را اضافه کنید.
- پروژه را Build کنید تا تغییرات اعمال شوند.
مرحله ۵: یک حساب گوگل دریافت کنید
برای استفاده از APIهای پیامهای نزدیک، به یک حساب گوگل نیاز دارید. اگر از قبل حساب دارید، همه چیز آماده است. همچنین ممکن است برای اهداف آزمایشی به یک حساب گوگل جداگانه نیاز داشته باشید.
مرحله ۶: دریافت کلید API
برای فعال کردن API پیامهای نزدیک گوگل برای iOS و دریافت کلید API، این مراحل را دنبال کنید:
- به کنسول توسعهدهندگان گوگل بروید.
- یک پروژه برای ثبت درخواست خود ایجاد یا انتخاب کنید.
- برای فعال کردن API روی ادامه کلیک کنید.
- در صفحه Credentials ، یک کلید iOS جدید ایجاد کنید (و API Credentials را تنظیم کنید).
توجه: اگر کلید iOS موجود دارید، میتوانید از آن کلید استفاده کنید. - در پنجرهی باز شده، شناسهی بستهی برنامهی خود را وارد کنید. برای مثال:
com.example.nearbyexample
- کلید API جدید iOS شما در لیست کلیدهای API پروژهتان ظاهر میشود. یک کلید API رشتهای از کاراکترها است، چیزی شبیه به این:
AIzaSyBdVl-cTICSwYKrZ95SuvNw7dbMuDt1KG0
- برای جلوگیری از سرقت سهمیه، کلید API خود را با پیروی از این بهترین شیوهها ایمن کنید.
مرحله 7: ایجاد یک شیء مدیریت پیام
شیء مدیریت پیام به شما امکان انتشار و اشتراک میدهد. تبادل پیام احراز هویت نشده است، بنابراین باید کلید API که در مرحله قبل ایجاد کردهاید را ارائه دهید.
هدف-سی
#import <GNSMessages.h>
GNSMessageManager *messageManager =
[[GNSMessageManager alloc] initWithAPIKey:@"API_KEY"];
سویفت
let messageManager = GNSMessageManager(APIKey: "API_KEY")