Google は AI 技術を使用して、コンテンツをご希望の言語に翻訳しています。AI 翻訳には誤りが含まれる場合があります。

開始する

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

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

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

ステップ 2: CocoaPods を取得する

iOS 向けの Google Nearby Messages API は CocoaPods pod として提供されています。CocoaPods は、Swift と Objective-C Cocoa プロジェクト用のオープンソースの依存関係マネージャーです。

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

$ sudo gem install cocoapods

ステップ 3: CocoaPods を使用して API をインストールする

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 と、それらの API が持つ依存関係がインストールされます。

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

ステップ 4: ブリッジングヘッダーを作成する（Swift のみ）

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

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

ステップ 5: Google アカウントを取得する

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

ステップ 6: API キーを取得する

iOS 向け Google Nearby Messages API を有効にして API キーを取得する手順は次のとおりです。

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

ステップ 7: メッセージマネージャーオブジェクトを作成する

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

Objective-C

#import <GNSMessages.h>

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

Swift

let messageManager = GNSMessageManager(APIKey: "API_KEY")