このページは Cloud Translation API によって翻訳されました。

開始する

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

ステップ 1: Xcode の最新版を入手する

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

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

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

$ sudo gem install cocoapods

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

Xcode プロジェクトをまだ作成していない場合は、ここで作成してローカルマシンに保存します。（iOS アプリを初めて開発する場合は、Single View Application を作成し、Use Automatic Reference Counting がオンになっていることを確認してください）。
プロジェクトのディレクトリに、Podfile という名前のファイルを作成します。このファイルでプロジェクトの依存関係を定義します。
Podfile を編集して、依存関係を追加します。以下は、iOS 用 Google Nearby Messages API に必要な Pod の名前を含むシンプルな 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 を使用してプロジェクトを作成した場合は、pod ファイルによってインストールされたライブラリを使用できるように、プロジェクトにブリッジングヘッダーを追加する必要があります。ブリッジヘッダーを追加する手順は次のとおりです。

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

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

iOS 用 Google Nearby Messages API を有効にして 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")