SoundCloudのAPIをつかったiOSアプリ開発の手順/ノウハウをまとめていくシリーズ。
まずは準備としてiOS SDKのインストールとビルドやパスやリンカーの設定から。
はじめに
英語がスラスラ読める人は以下の元のページを参照した方が理解が深まります。
基本的に元のページと内容は一緒ですので。
参考:SoundCloud iOS SDK
http://developers.soundcloud.com/docs/api/ios-quickstart
アプリ名登録
今回は特に必要ありませんが、ガイドラインの流れに沿って一応載せておきます。
後ほどOAuth認証をする為にいずれは設定が必要なので。
アプリ名は以下のページから登録します。
http://soundcloud.com/you/apps
上記のページにて、"Register a new application"をクリック
次のページで、アプリ名を入力して"Register"をクリック。
その次のページでは、"Website of your app"とか"Redirect URI for Authentication"
とかあるけど、後で編集可能なのでここはとりあえず空欄でよいです。
"Redirect URI for Authentication"には、OAuth認証の際のURLを決めて入力します。
my-app://soundcloud/callback
とかでいいとおもいます
参考:HTTP API Guide -Authentication-
http://developers.soundcloud.com/docs#authentication
"Developer Policies"に同意するためのチェックだけをつけて、"Save app"をクリックで登録完了です。
アプリ名が気に入らなかったら後で登録しなおせばいいのでこのフェーズはさらっと流しちゃってください。
SDKインストール & 各種設定
SoundCoudのクイックスタートガイドに沿って準備します
参考:Install SDK and Dependencies
http://developers.soundcloud.com/docs/api/ios-quickstart#installation
サブモジュールのチェックアウト
まずは開発に必要なサブモジュールをチェックアウトしてきます。
ターミナルよりSDKをインストールするプロジェクトのディレクトリ下に移動して、以下のコマンドを実行します。
git submodule add git://github.com/soundcloud/CocoaSoundCloudAPI.git
git submodule add git://github.com/nxtbgthng/OAuth2Client.git
git submodule add git://github.com/nxtbgthng/JSONKit.git
git submodule add git://github.com/nxtbgthng/OHAttributedLabel.git
git submodule add git://github.com/soundcloud/CocoaSoundCloudUI.git
SoundCloud iOS SDK, OAuth, JSON, UIに関するサブモジュールがチェックアウトされます。
サブモジュールをプロジェクトに追加
次にチェックアウトしたサブモジュールをアプリのプロジェクトに追加します。
Xcodeを開いて、プロジェクトファイルを右クリック->"Add Files to Project"より、
CocoaSoundCloudAPI, CocoaSoundCloudUI, JSONKit, OAuth2Client, OHAttributedLabelのそれぞれのプロジェクトファイルをインポートします。
チェックアウトしてきたサブモジュールのフォルダの下にプロジェクトファイルがあります、
パスの追加
Project Navigatorより、"Build Settings"->"Header Search Paths"に$PROJECT_DIR
を追加します。また、$PROJECT_DIR
の設定を"non-recursive" -> "recursive"に変更します。
依存関係の追加
Project Navigatorより、"Build Phases"->"Target Dependencies"に
libSoundCloudUI, OAuth2Client, libJSONKit, OHAttributedLabel, SoundCloudAPIをそれぞれ追加
ライブラリの追加
Project Navigatorより、"Build Phases"->"Link Binary with Libraries"に
・libJSONKit.a
・libOAuth2Client.a
・libOHAttributedLabel.a
・libSoundCloudAPI.a
・libSoundCloudUI.a
・AddressBook.framework
・AddressBookUI.framework
・CoreGraphics.framework
・CoreLocation.framework
・CoreText.framework
・QuartzCore.framework
・Security.framework
をそれぞれ追加
リンカーの設定
Project Navigatorより、"Build Settings"->"Other Linker Flags"に-all_load -ObjC
を追加。
Bundleファイルの追加
チェックアウトしてきたサブモジュールCocoaSoundCloudUIの下にある"SoundCloud.bundle"をXcodeのプロジェクトにドラグ&ドロップします。
次にダイアログが出てくるので "Copy items into destination group's folder (if needed) "にチェッックをつけて"Finish"を選択。
おわりに
以上、これでセットアップ完了です!
セットアップが完了したらアカウント認証編へ続きます(多分)。
何か抜け漏れや認識間違い等ありましたらご指摘頂けたらと思います。