スタート ガイド

このドキュメントでは、Google Chat で Nearby Messages API を使って開発を行う方法について説明します iOS。

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

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

ステップ 2: CocoaPods を入手する

iOS 用の Google Nearby Messages API は、 CocoaPods Pod。CocoaPods はオープンソースの依存関係 担当マネージャーを務めています。

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

$ sudo gem install cocoapods

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

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

  • Xcode プロジェクトがまだない場合は、ここで作成して 作成します。（iOS 開発を初めて行う場合は、シングル ビューを作成してください）。 [Use Automatic Reference Counting] がオンになっていることを確認します）。
  • プロジェクトのディレクトリに、Podfile という名前のファイルを作成します。このファイルでは、 依存関係が存在します。

  • Podfile を編集して、依存関係を追加します。これはシンプルな Podspec で、 Google Nearby Messages API に必要な Pod の名前を含めてください。 iOS: 

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

  • Podfile を保存します。

  • ターミナルを開き、Podfile を含むディレクトリに移動します。

    CD $

  • pod install コマンドを実行します。これにより、指定した API がインストールされます。 Podspec とそれらの依存関係が存在する場合があります。

    Pod インストール（$）

  • Xcode を閉じて、プロジェクトの .xcworkspace ファイルを開く（ダブルクリック） Xcode を起動します。これ以降、.xcworkspace ファイルを使用して以下を行う必要があります。 プロジェクトを開きます。

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

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

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

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

Nearby Messages API を使用するには Google アカウントが必要です。 すでにアカウントをお持ちの場合は、これで完了です。さらに、 テスト用に別の Google アカウントを作成します。

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

次の手順に沿って、iOS 用の Google Nearby Messages API を有効にして、 API キー:

  1. <ph type="x-smartling-placeholder"></ph>に行く Google Developers Console をご覧ください。
  2. アプリケーションを登録するプロジェクトを作成または選択します。
  3. [続行] をクリックして API を有効にします。
  4. [認証情報] ページで新しい iOS キーを作成し、API を設定します。 。
    注: 既存の iOS キーがある場合は、そのキーを使用できます。
  5. 表示されるダイアログで、アプリのバンドル ID を入力します。次に例を示します。
    com.example.nearbyexample
  6. プロジェクトの API キーのリストに新しい iOS API キーが表示されます。 API キーは次のような文字列です。 
    AIzaSyBdVl-cTICSwYKrZ95SuvNw7dbMuDt1KG0
  7. 割り当ての盗用を防ぐため、次の手順に沿って API キーを保護してください ベスト プラクティスをご覧ください。
で確認できます。

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

メッセージ マネージャー オブジェクトを使用すると、パブリッシュとサブスクライブを行うことができます。メッセージ交換: 未認証なので、前のステップで作成した API キーを 示します。

Objective-C

#import <GNSMessages.h>

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

Swift

let messageManager = GNSMessageManager(APIKey: "API_KEY")