Google uses AI technology to translate content into your preferred language. AI translations can contain errors.

開始する

このドキュメントでは、iOS で Nearby Messages API を使用した開発を開始する方法について説明します。

ステップ 1: Xcode の最新バージョンを入手する

Google Nearby Messages API for iOS を使用してプロジェクトを作成するには、 バージョン 6.3 以降の Xcode が必要です。

Google Nearby Messages API for iOS は CocoaPods ポッドとして提供されています。CocoaPods は、Swift と Objective-C の Cocoa プロジェクトで依存関係を管理するためのオープンソースツールです。

CocoaPods ツールがない場合は、ターミナルから以下のコマンドを実行して、OS X 上に CocoaPods ツールをインストールします。詳しくは、CocoaPods スタートガイドをご覧ください。

$ sudo gem install cocoapods

Google Nearby Messages API for iOS の Podfile を作成し、これを使用して API とその依存関係をインストールします。

Xcode プロジェクトをまだ作成していない場合は、ここで作成してローカルマシンに保存します（iOS アプリを初めて開発する場合は、Single View Application を作成し、[Use Automatic Reference Counting] がオンになっていることを確認します）。
プロジェクトのディレクトリに、Podfile という名前のファイルを作成します。このファイルでプロジェクトの依存関係を定義します。
Podfile を編集して、依存関係を追加します。Google Nearby Messages API for iOS に必要なポッドの名前を含む簡単な Podspec を次に示します。
```
source 'https://github.com/CocoaPods/Specs.git'
platform :ios, '7.0'
pod 'NearbyMessages'
```
Podfile を保存します。
ターミナルを開き、Podfile を含むディレクトリに移動します。

$ cd
pod install コマンドを実行します。Podspec で指定した API とその依存関係がインストールされます。

$ pod install
Xcode を終了し、プロジェクトの .xcworkspace ファイルを（ダブルクリックして）開いて、Xcode を起動します。これ以降、このプロジェクトを開くには .xcworkspace ファイルを使用する必要があります。

Swift を使用してプロジェクトを作成した場合は、ポッドファイルによってインストールされたライブラリを使用できるように、ブリッジングヘッダーをプロジェクトに追加する必要があります。ブリッジングヘッダーを追加する手順は次のとおりです。

プロジェクトの .xcworkspace ファイルと同じディレクトリに、新しいヘッダーファイルを追加します（任意の名前を付け、ファイル名拡張子として「.h」を使用します）。
作成したファイルに次のコードを貼り付けます。 #import <GNSMessages.h>
ファイルを保存します。
プロジェクトエディタの左側のペインで、メインプロジェクトを選択します。
ビルドエディタの上部にある [Build Settings] をクリックします。
[Build Settings] で、[Swift Compiler - Code Generation] に移動します（検索ボックスに「Swift Compiler」と入力すると、すばやく見つけることができます）。
矢印をクリックして、[Objective-C Bridging Header] セクションを開きます。
[Debug] と [Release] の下に、作成したヘッダーファイルのパスを追加します。
プロジェクトをビルドして、変更を有効にします。

Nearby Messages API を使用するには、Google アカウントが必要です。すでにアカウントをお持ちの場合は、それを使用できます。テスト用に別の Google アカウントを取得することもできます。

次の手順に沿って、Google Nearby Messages API for iOS を有効にして API キーを取得します。

Google Developers Console にアクセスします。
アプリケーションを登録するプロジェクトを作成または選択します。
[続行] をクリックして API を有効にします。
[認証情報] ページで、新しいiOS キー を作成します（API 認証情報を設定します）。
注: 既存の iOS キー がある場合は、そのキーを使用してもかまいません。
表示されるダイアログで、アプリのバンドル ID を入力します。次に例を示します。
```
com.example.nearbyexample
```
プロジェクトの API キーのリストに、新しい iOS API キーが表示されます。 API キーは次のような文字列です。
```
AIzaSyBdVl-cTICSwYKrZ95SuvNw7dbMuDt1KG0
```
割り当ての盗用を防ぐため、次のベストプラクティスに沿って API キーを保護してください。

メッセージマネージャーオブジェクトを使用すると、パブリッシュとサブスクライブを行うことができます。メッセージ交換は認証されていないため、前の手順で作成した API キーを指定する必要があります。

#import <GNSMessages.h>

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

let messageManager = GNSMessageManager(APIKey: "API_KEY")