SwiftでDropbox APIを使用する準備を行う。

この記事は2018年06月11日に投稿しました。
この記事は2018年07月20日に更新しました。

f:id:paveway:20190914064630j:plain

1. はじめに

こんにちは、iOSのエディタアプリPWEditorの開発者の二俣です。

iOSアプリのPWEditorはSwift言語で作成しています。
PWEditorからDropboxのテキストファイルの読み書きを行っております。
その機能を実現するため、Swift版のDropbox APIを利用しています。
これから何回かに分けて、PWEditorでDropbox APIをどう利用したかまとめてみたいと思います。

目次へ

2. 前提

これから説明する手順はDropbox公式ドキュメントDropbox for Swiftに従った手順になります。
不明点等があった場合は、お手数ですが公式ドキュメントDropbox for Swiftを参照してください。
またDropbox APIの利用には、Dropboxのアカウントが必要となります。
Dropboxのアカウントをお持ちではない方は、先にアカウントを作成してください。

目次へ

3. 準備手順

3-1. アプリ登録

iOSアプリからDropbox APIを利用するためには、Dropboxへアプリの登録が必要となります。
アプリの登録は次の手順で行います。
この段階でアプリは存在しなくても構いません。

https://www.dropbox.com/developers/appsを開きます。
Dropboxにログインしていないとログイン画面が開くので、Dropboxにログインしてください。
My apps画面が開きます。
My apps画面が開かない場合は、左側のメニューから"My apps"リンクを押下してください。
My apps画面右上の"Create app"ボタンをクリックし、"Create a new app on the DBX Platform"画面を開きます。
"Choose an API"は"Dropbox API"を選択してください。
"Choose the type of access you need"の"App folder"または"Full Dropbox"を選択してください。
"App folder"はアプリが作成したフォルダのみアクセス可能になります。
"Full Dropbox"はログインしたユーザのDropboxのフォルダにアクセス可能になります。
PWEditorは他のデバイスとファイルを共有するため、"Full Dropbox"を選択しています。
"Name your app"で任意のアプリ名を付けます。
アプリ名は全世界でユニークである必要があります。
またDropboxのガイドラインに従った命名の名前である必要があります。
右下の"Create app"ボタンをクリックします。
アプリ用の設定画面が開きます。
"App key"項目の値は後で使用するため、コピーしておいてください。

目次へ

3-2. Xcodeプロジェクトの作成

アプリ用のXcodeプロジェクトを作成します。
ウィザードに従って作成してください。
念のためビルド、起動するところまで確認しておきます。
起動するところまで確認しておくと、あとでトラブルがあった時に原因を切り分けやすくなります。
のちほどDropboxと連携する設定を行います。

目次へ

3-3. Dropbox APIのライブラリのインストール

Dropbox APIのライブラリを、cocoapodでインストールします。
他の方法(Carthage等)でインストールしたい場合は、公式ドキュメントを参照してください。

次のようなPodfileを準備します。
Podfileの"<プロジェクト名>"の部分は、作成したプロジェクトの名前に置き換えてください。

use_frameworks!

target '<プロジェクト名>' do
    pod 'SwiftyDropbox'
end

ターミナルでプロジェクトのディレクトリを開き、次のコマンドを実行します。

pod install

目次へ

3-4. Dropboxと連携する設定

Xcodeで作成したプロジェクトとDropbox APIを連携させる設定を行います。

先ほど作成したXcodeのプロジェクトを開いてください。
"Info.plist"を選択してください。
"Information Property List"の配下に、"LSApplicationQueriesSchemes"をArray"として追加してください。
追加された"LSApplicationQueriesSchemes"の"+"ボタンを押下してください。
追加された"Item 0"のValueに"dbapi-8-emm"を入力してください。
同様に"Item 1"も追加し、Valueに"dbapi-2"を入力してください。
"Information Property List"配下に、"URL types"を追加してください。
追加された"URL types"配下の"Item 0"配下に"URL Schemes"を追加してください。
"URL Schemes"配下の"Item 0"の"Value"にdb-AppKey"を入力してください。
"db-AppKey"の"AppKey"部分は、"アプリ登録"でコピーしておいた"App Key"に置き換えてください。

目次へ

4. おわりに

これでDropbox APIを利用する準備は整いました。
次は初期化処理を行います。

とりあえず稼ぎたいなら、ITエンジニア【IT派遣テクノウェイブ】

目次へ

私が勤務しているニューラルでは、主に組み込み系ソフトの開発を行っております。
弊社製品のハイブリッドOS Bi-OSは高い技術力を評価されており、特に制御系や通信系を得意としています。
私自身はiOSモバイルアプリやウィンドウズアプリを得意としております。
ソフトウェア開発に関して相談などございましたら、お気軽にご連絡ください。

また一緒に働きたい技術者の方も随時募集中です。
興味がありましたらご連絡ください。

EMAIL : info-nr@newral.co.jp / m-futamata@newral.co.jp
TEL : 042-523-3663
FAX : 042-540-1688

目次へ

プログラムを書こう！

実務や自作アプリ開発で習得した役に立つソフトウェア技術情報を発信するブログ