این سند نحوه شروع توسعه با Nearby Messages API در iOS را توضیح می دهد.
مرحله 1: آخرین نسخه Xcode را دریافت کنید
برای ساختن یک پروژه با استفاده از Google Nearby Messages API برای iOS، به نسخه 6.3 یا جدیدتر Xcode نیاز دارید.
مرحله 2: CocoaPods را دریافت کنید
Google Nearby Messages API برای iOS به عنوان یک CocoaPods در دسترس است. CocoaPods یک مدیر وابستگی منبع باز برای پروژه های Swift و Objective-C Cocoa است.
اگر از قبل ابزار CocoaPods را ندارید، با اجرای دستور زیر از ترمینال، آن را روی OS X نصب کنید. برای جزئیات، به راهنمای شروع به کار CocoaPods مراجعه کنید.
$ sudo gem install cocoapods
مرحله 3: API را با استفاده از CocoaPods نصب کنید
یک Podfile برای Google Nearby Messages API برای iOS ایجاد کنید و از آن برای نصب API و وابستگی های آن استفاده کنید.
- اگر هنوز پروژه Xcode ندارید، اکنون یکی را ایجاد کرده و آن را در دستگاه محلی خود ذخیره کنید. (اگر در توسعه iOS تازه کار هستید، یک برنامه Single View ایجاد کنید و مطمئن شوید که Use Automatic Reference Counting روشن است.)
- یک فایل به نام
Podfileدر دایرکتوری پروژه خود ایجاد کنید. این فایل وابستگی های پروژه شما را تعریف می کند. Podfileرا ویرایش کنید و وابستگی های خود را اضافه کنید. در اینجا یک Podspec ساده، شامل نام pod مورد نیاز برای Google Nearby Messages API برای iOS آمده است:source 'https://github.com/CocoaPods/Specs.git' platform :ios, '7.0' pod 'NearbyMessages'
Podfileذخیره کنید.یک ترمینال را باز کنید و به دایرکتوری حاوی
Podfileبروید:$ سی دی
دستور
pod installرا اجرا کنید. این API های مشخص شده در Podspec را به همراه وابستگی هایی که ممکن است داشته باشند نصب می کند.$ pod نصب کنید
Xcode را ببندید و سپس فایل
.xcworkspaceپروژه خود را باز کنید (دوبار کلیک کنید) تا Xcode راه اندازی شود. از این زمان به بعد باید از فایل.xcworkspaceبرای باز کردن پروژه استفاده کنید.
مرحله 4: ایجاد یک هدر پل زدن (فقط Swift)
اگر پروژه خود را با استفاده از سوئیفت ایجاد کرده اید، باید یک هدر پل زدن به پروژه خود اضافه کنید تا بتواند از کتابخانه های نصب شده توسط فایل پاد استفاده کند. این مراحل را برای افزودن یک هدر پل زدن انجام دهید:
- در همان فهرستی که فایل
.xcworkspaceپروژه شما قرار دارد، یک فایل هدر جدید اضافه کنید (آن را هر چه دوست دارید نامگذاری کنید و از پسوند نام فایل ".h" استفاده کنید). - کد زیر را در فایلی که ایجاد کردید قرار دهید:
#import <GNSMessages.h>. - فایل را ذخیره کنید.
- در پنجره سمت چپ ویرایشگر پروژه، پروژه اصلی را انتخاب کنید.
- روی Build Settings در بالای ویرایشگر ساخت کلیک کنید.
- در Build Settings، به "Swift Compiler - Code Generation" بروید ("Swift Compiler" را در کادر جستجو تایپ کنید تا سریع آن را پیدا کنید).
- برای گسترش بخش Objective-C Bridging Header روی فلش کلیک کنید.
- در قسمت Debug and Release ، مسیر را به فایل هدری که ایجاد کردید اضافه کنید.
- پروژه را بسازید تا تغییرات اعمال شود.
مرحله 5: یک حساب Google دریافت کنید
برای استفاده از Nearby Messages API، به یک حساب Google نیاز دارید. اگر قبلاً یک حساب کاربری دارید، پس همه چیز آماده است. همچنین ممکن است یک حساب Google جداگانه برای اهداف آزمایشی بخواهید.
مرحله 6: یک کلید API دریافت کنید
برای فعال کردن Google Nearby Messages API برای iOS و دریافت یک کلید API، این مراحل را انجام دهید:
- به Google Developers Console بروید.
- پروژه ای را برای ثبت درخواست خود ایجاد یا انتخاب کنید.
- برای فعال کردن API روی Continue کلیک کنید.
- در صفحه Credentials ، یک کلید iOS جدید ایجاد کنید (و API Credentials را تنظیم کنید).
توجه: اگر یک کلید iOS موجود دارید، می‌توانید از آن کلید استفاده کنید. - در گفتگوی به دست آمده، شناسه بسته نرم افزاری خود را وارد کنید. به عنوان مثال:
com.example.nearbyexample
- کلید جدید iOS API شما در لیست کلیدهای API پروژه شما ظاهر می شود. یک کلید API رشته ای از کاراکترها است، چیزی شبیه به این:
AIzaSyBdVl-cTICSwYKrZ95SuvNw7dbMuDt1KG0
- برای جلوگیری از سرقت سهمیه، کلید API خود را با رعایت این بهترین شیوه‌ها ایمن کنید.
مرحله 7: یک شی مدیر پیام ایجاد کنید
شیء مدیر پیام به شما امکان می دهد منتشر کنید و مشترک شوید. تبادل پیام احراز هویت نشده است، بنابراین باید کلید API را که در مرحله قبل ایجاد کرده‌اید، ارائه دهید.
هدف-C
#import <GNSMessages.h>
GNSMessageManager *messageManager =
[[GNSMessageManager alloc] initWithAPIKey:@"API_KEY"];
سویفت
let messageManager = GNSMessageManager(APIKey: "API_KEY")