شروع کنید

هشدار: «پیام‌های اطراف» منسوخ شده است و از دسامبر ۲۰۲۳ دیگر کار نخواهد کرد. لطفاً برای پشتیبانی بیشتر به اتصال‌های اطراف یا دستورالعمل انتقال درباره نحوه انتقال استفاده از «پیام‌های اطراف» به «اتصال‌های اطراف» بروید.

این سند نحوه شروع توسعه با «میانای برنامه‌سازی کاربردی پیام‌های اطراف» در iOS را توضیح می‌دهد.

مرحله ۱: دریافت جدیدترین نسخه Xcode

برای ساختن پروژه بااستفاده از Google Nearby Messages API برای iOS، به نسخه ۶.۳ یا بالاتر Xcode نیاز دارید.

مرحله ۲: دریافت CocoaPods

Google Nearby Messages API برای iOS به‌صورت CocoaPods pod دردسترس است. ‫CocoaPods مدیر وابستگی متن‌باز برای پروژه‌های Swift و Objective-C Cocoa است.

اگر ازقبل ابزار CocoaPods را ندارید، آن را با اجرای فرمان زیر از پایانه در OS X نصب کنید. برای جزئیات، راهنمای شروع به کار CocoaPods را ببینید.

$ sudo gem install cocoapods

مرحله ۳: نصب API بااستفاده از CocoaPods

Podfile برای Google Nearby Messages API ویژه iOS ایجاد کنید و از آن برای نصب API و وابستگی‌های آن استفاده کنید.

• اگر هنوز پروژه Xcode ندارید، اکنون یکی ایجاد کنید و آن را در دستگاه محلی خود ذخیره کنید. (اگر در توسعه iOS تازه‌کار هستید، «برنامه نمای واحد» ایجاد کنید و مطمئن شوید که «استفاده از شمارش مرجع خودکار» روشن باشد.)
• فایلی به‌نام Podfile در دایرکتوری پروژه خود ایجاد کنید. این فایل وابستگی‌های پروژه‌تان را تعریف می‌کند.

• ‫Podfile را ویرایش کنید و وابستگی‌هایتان را اضافه کنید. در اینجا یک Podspec ساده وجود دارد، شامل نام غلافی که برای Google Nearby Messages API برای iOS نیاز دارید:

  source 'https://github.com/CocoaPods/Specs.git'
  platform :ios, '7.0'
  pod 'NearbyMessages'

• ‫Podfile را ذخیره کنید.

• پایانه‌ای را باز کنید و به دایرکتوری حاوی Podfile بروید:

  $ cd

• فرمان pod install را اجرا کنید. این کار باعث نصب شدن میاناهای برنامه‌سازی کاربردی مشخص‌شده در Podspec به‌همراه هرگونه وابستگی آن‌ها می‌شود.

  ‫$ pod install

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

مرحله ۴: ایجاد سرصفحه پل (فقط Swift)

اگر پروژه‌تان را بااستفاده از Swift ایجاد کرده‌اید، باید سرصفحه پل‌سازی به پروژه‌تان اضافه کنید تا بتواند از کتابخانه‌هایی که فایل pod نصب کرده است استفاده کند. برای افزودن سرایند پل‌سازی، این مراحل را انجام دهید:

1. در همان دایرکتوری فایل .xcworkspace پروژه، فایل سرصفحه جدیدی اضافه کنید (نام آن را هرچه می‌خواهید بگذارید و از پسوند نام فایل «.h» استفاده کنید).
2. کد زیر را در فایلی که ایجاد کرده‌اید جای‌گذاری کنید: #import <GNSMessages.h>.
3. فایل را ذخیره کنید.
4. در قاب سمت راست ویرایشگر پروژه، پروژه اصلی را انتخاب کنید.
5. در بالای ویرایشگر ساخت، روی تنظیمات ساخت کلیک کنید.
6. در Build Settings (تنظیمات ساخت)، به «Swift Compiler - Code Generation» (کامپایلر Swift - تولید کد) بروید (برای پیدا کردن سریع آن، «Swift Compiler» (کامپایلر Swift) را در چارگوش جستجو تایپ کنید).
7. روی پیکان کلیک کنید تا بخش Objective-C Bridging Header ازهم باز شود.
8. در بخش عیب‌یابی و انتشار، مسیر فایل سرصفحه‌ای را که ایجاد کرده‌اید اضافه کنید.
9. برای اعمال تغییرات، پروژه را بسازید.

مرحله ۵: دریافت حساب Google

برای استفاده از «میاناهای برنامه‌سازی کاربردی پیام‌های اطراف»، به حساب Google نیاز دارید. اگر ازقبل حساب دارید، همه چیز آماده است. همچنین ممکن است بخواهید برای اهداف آزمایش، «حساب Google» جداگانه‌ای داشته باشید.

مرحله ۶: دریافت کلید میانای API (کلید میانای برنامه‌سازی کاربردی)

برای فعال کردن Google Nearby Messages API برای iOS و دریافت کلید API، این مراحل را انجام دهید:

1. به Google Developers Console بروید.
2. پروژه‌ای را برای ثبت کردن برنامه‌تان ایجاد یا انتخاب کنید.
3. برای فعال کردن «میانای برنامه‌سازی کاربردی»، روی ادامه کلیک کنید.
4. در صفحه اطلاعات کاربری، کلید iOS جدیدی ایجاد کنید (و اطلاعات کاربری API را تنظیم کنید).
   توجه: اگر کلید iOS موجود دارید، می‌توانید از آن کلید استفاده کنید.
5. در چارگوش گفتگوی حاصل، شناسه دسته‌ای برنامه‌تان را وارد کنید. برای مثال:

   com.example.nearbyexample

6. کلید جدید iOS API شما در فهرست کلیدهای API برای پروژه شما ظاهر می‌شود. کلید API رشته‌ای از نویسه‌ها است، چیزی شبیه به این:

   AIzaSyBdVl-cTICSwYKrZ95SuvNw7dbMuDt1KG0

7. برای جلوگیری از سرقت سهمیه، کلید API خود را با دنبال کردن این روال‌های مطلوب ایمن کنید.

توجه: اگر درحال توسعه برنامه Android یا استفاده از Proximity Beacon REST API هستید، مطمئن شوید که همه کلیدهای API مربوطه را در پروژه Google Developers Console یکسانی تولید کنید. برای اطلاعات بیشتر، به راهنمای شروع کار برای Android، و شروع کار با REST API مراجعه کنید.

مرحله ۷: ایجاد شیء مدیر پیام

شیء مدیر پیام به شما امکان می‌دهد منتشر کنید و مشترک شوید. تبادل پیام احراز هویت نشده است، بنابراین باید کلید میانای برنامه‌سازی کاربردی را که در مرحله قبلی ایجاد کرده‌اید ارائه دهید.

آبجکتیو-سی

#import <GNSMessages.h>

GNSMessageManager *messageManager =
    [[GNSMessageManager alloc] initWithAPIKey:@"API_KEY"];

Swift

let messageManager = GNSMessageManager(APIKey: "API_KEY")