2011/11/23

Dropbox SDK for Android を使ってみた (1) - 前準備

DropBox は Android からアクセスできるAPIを提供してくれています。
今回、ちょっとそのSDKを使ってみたので、その方法を書いておこうと思います。

まずは、前準備から。

  1. Android Project 作成
    いつものごとく、Eclipse 上で Android プロジェクトを作成します

  2. Dropbox SDK をダウンロード
    以下のページから Android 用のSDKをダウンロードします。

    https://www.dropbox.com/developers/reference/sdk

    今回は、v1.2.1 をダウンロードしてきました

  3. lib をプロジェクトにコピー
    ダウンロードしてきた Zip ファイルを展開すると、lib というディレクトリがあります。
    このlibディレクトリを作成したAndroidプロジェクトに加えてやります。

    libディレクトリを加える方法はいろいろありますが、Eclipse上にドラッグ&ドロップで追加するのが簡単でしょう。

  4. jar ファイルをビルドパスに追加
    追加したjarファイルを右クリックして Add to Build Path

  5. App key を作成
    Dropbox SDK を使うには、アプリケーションごとに App key というのを登録しなければなりません。
    以下のサイトに自分のDropboxアカウントでログインして、アプリケーションを登録します。
    https://www.dropbox.com/developers/apps

    以下のような画面が表示されるので、必要な情報を入力します。
    この時、App folder を選択すると、App name のディレクトリが自動的に作られ、そのディレクトリ以下にしかアクセスできなくなります。
    Full Dropbox を選択すると、全てのディレクトリにアクセスできます。
    用途に応じて選択しましょう。

    作成が完了すると、 App key と App Secret というコードが見られるはずです。

    普通に作ると、App Status は Development になっているかと思います。この状態では、作ったアプリは自分のアカウントでしかでログインできません。マーケットに出すには、production status に変更しなければならないので注意してください。
  6. AndroidManifest.xml 修正
    以下のように、AuthActivityというActivity を登録してやります。このとき、App Key は先ほど取得した値に変更します。
    このApp Key には、頭に“db-”をつけてやる必要がありますので、注意が必要です。
    また、uses-permission の項目を追加して、インターネットアクセスを許可してやります。

    AndroidManifest.xml
    <?xml version="1.0" encoding="utf-8"?>
<manifest xmlns:android="http://schemas.android.com/apk/res/android"
    package="com.kokufu.test.dropboxtest"
    android:versionCode="1"
    android:versionName="1.0" >

    <uses-sdk android:minSdkVersion="8" />

    <application
        android:icon="@drawable/ic_launcher"
        android:label="@string/app_name" >
        <activity
            android:label="@string/app_name"
            android:name=".DropboxTestActivity" >
            <intent-filter >
                <action android:name="android.intent.action.MAIN" />
                <category android:name="android.intent.category.LAUNCHER" />
            </intent-filter>
        </activity>
        <!-- 以下のActivityを加えます。このとき、dataタグのschemeは自分で取得したApp key に“db-”をつけたものに変更します。 -->
        <activity
          android:name="com.dropbox.client2.android.AuthActivity"
          android:launchMode="singleTask"
          android:configChanges="orientation|keyboard">
          <intent-filter>
            <!-- Change this to be db- followed by your app key -->
            <data android:scheme="db-CHANGE_ME" />
            <action android:name="android.intent.action.VIEW" />                
            <category android:name="android.intent.category.BROWSABLE"/>
            <category android:name="android.intent.category.DEFAULT" /> 
          </intent-filter>
        </activity>

    </application>
    <!-- 以下の行を加えます -->
    <uses-permission android:name="android.permission.INTERNET"></uses-permission>

</manifest>
以上で、Dropbox SDK を使う準備が整いました。 あとは、SDKを使ったアプリを書いていくだけです。

Next: Dropbox SDK for Android を使ってみた (2) - 認証画面を表示する

0 件のコメント:

コメントを投稿