2012年12月13日 星期四

安裝 Python SDK

如下表,Dropbox 官方提供了 iOS, Android, Python, Ruby, Java 以及 OS X 等 SDK,你可以從中選一個喜歡的來使用。除了官方的 SDK,社群成員也貢獻了使用其它程式語言寫成的 Third party SDKs,你可以這個頁面裏找到。在這篇我將說明 Python SDK 的安裝,我所用的環境是 Windows 7:

Step 1: 連到 Dropbox SDK 這個頁面,如下圖所示,點選 Python 右手邊的 Dropbox+ 圖示:

image
▲ 後來發現,其實點左手邊的語言或環境也可以下載 SDK

Step 2: 這時候會跳出底下這個小視窗,直接點選 "Add to Dropbox":

image

接著 Python SDK 就會裝到你的 Dropbox。如下圖,Dropbox 會多出 "dropbox-python-sdk-1.5.1" 這個資料夾:

image

而 "dropbox-python-sdk-1.5.1" 資料夾裏的檔案結構如下:

image

Step 3: 開一個 DOS 視窗,並切到 "dropbox-python-sdk-1.5.1" 資料夾,然後輸入底下指令安裝 Python SDK (注意! 在執行下列指令前,你必須先刪掉 build 這個檔,不然安裝會失敗) :

python setup.py install

Python SDK 的安裝就這麼簡單,安裝好後,你就可以用拿到的 App key 和 App secret 來存取 Dropbox API。

在 example 資料夾中有一些可供參考的 sample scripts,其中 cli_client.py 是一個 Dropbox 的指令介面工具,而 web_upload_app.py 則可以讓你透過 Web 上傳檔案到 Dropbox。下一篇我將說明如何使用這兩支工具。

參考資料

2012年12月12日 星期三

建立 app 取得 App key 與 App Secret

這篇將說明如何建立 Dropbox app 以取得 App key 與 App Secret:

Step 1: 連到 Dropbox 的 My apps 這個網頁,如果你是第一次建立 app,要先同意 Dropbox 的服務條款:

image

Step 2: 點選 "Create an app":

image

Step 3: 輸入 App name 和 Description 並選擇 Access type。Access type 有 App folder 和 Full Dropbox 兩種,一般來說使用 App folder 就好,輸入完後點選 Create:

image

有關 Access types 的種類,簡單說明如下 :

  • App folder – 你的 app 只能存取使用者的 Dropbox 的某一個專用的資料夾 (與 app 同名),會放在使用者 Dropbox 的 Apps 這個資料夾底下
  • Full Dropbox – 你的 app 可以存取使用者整個 Dropbox

Step 4: 建立好 app 後,你就可以取得 App key 與 App secret:

image

App 在開發階段有一個 5 個 users 的使用限制,如果你將來要讓 app 正式產品化,要點上圖的 "Apply for production status" 提出申請。

Step 5: 在同一個頁面下方,你還可以設定 app 額外的資訊,例如 Website, Icon 檔等:

image

前面提到,App 在開發階段有一個 5 個 users 的使用限制,不過這個功能預設並沒有打開,你要自己點上圖的 "Enable additional users" 然後點選下圖的 Enable 才可以把 users 數量提高到 5 個:

image

當你取得 App key 和 App Secret 之後,就可以用 Dropbox SDK 來開發 app。目前 Dropbox 官方提供了 iOS, Android, Python, Ruby, Java 和 OSX 等多種 SDK,你可以選擇一個你喜歡的平台來用。下一篇我將說明 Python SDK 的安裝。

2012年12月6日 星期四

Enable telnet on Windows 8

Windows 8 預設沒有安裝 Telnet Client,你可以照著底下的步驟把它裝「回」來:

1) 打開控制台,點選「程式集」:

image

2) 選擇「開啟或關閉 Windows 功能」:

image

3) 在 「Windows 功能」視窗中,勾選「Telnet 用戶端」,然後按下確定開始安裝:

image

安裝完畢後,你就有 Telnet 指令可以使用了:

image

image