安裝和設定建置自訂 Api 的Oracle Mobile Hub 工具

您可以下載及設定其他工具，在Oracle Mobile Hub中部署自訂 api。

安裝 Node.js 工具

當您從 Oracle Technology Network (OTN) 下載 SDK 時，可以選擇下載 omce-tools-vXX.X.X 檔案，其中包含可供您將應用程式建置到Oracle Mobile Hub的 Node.js 命令檔。

若要在專案中安裝 Node.js 工具：

1. 下載omce-tools-vXX.X.X壓縮檔，並將壓縮檔解壓縮至目錄
2. 在您的機器上開啟終端機視窗 (可能必須以管理員使用者身分執行此命令)，然後變更為 omce-tools/node-configurations 目錄。
3. 判斷您需要用於所測試自訂 API 的節點組態。請將6.10用於節點版本 6.10.0 或相容，然後在節點版本 8.9.4 使用8.9或是相容。Oracle Mobile Hub 的預設節點組態為8.9.
4. 變更要使用之節點組態的目錄：'6.10`或`8.9`
5. 執行下列命令：

   npm install

6. 變更至 omce-tools 目錄。
7. 執行命令：

   npm install -g

   此命令可在您的本機環境中全域提供工具。執行此命令之前，必須先安裝 Node.js 和 npm 套裝程式管理程式。

8. 將您要使用的節點組態的環境變數 NODE_PATH 設為 node_modules 目錄，或設為 path/omce-tools/node-configurations/8.9/node_modules。
9. 若要測試安裝是否成功，請執行下列命令：

   omce-test --version

下載自訂 API 的 JavaScript Scaffold

建立自訂 API 之後，您可以下載以您的 API RAML 文件為基礎的 scaffold，然後使用 scaffold 做為實行您自訂 API 的快速起點。

Scaffold 的形式為「節點」模組、主要 JavaScript 檔案的主要元件，其中包含每個端點 (資源加上 HTTP 方法) 的 stub 方法，以及當作模組資訊清單的 package.json 檔案。

若要下載 scaffold：

1. 按一下 以開啟側邊功能表，按一下開發 ，然後按一下 api。
2. 開啟您要下載的 API。
3. 在「API 設計工具」的左側導覽區域中，按一下實行。
4. 按一下 JavaScript Scaffold 即可下載壓縮檔。
5. 在您的系統上解壓縮下載的檔案。

若您稍後變更 API，則可依據更新的端點下載新的結構舊。不過，您先前可能已完成且上傳的任何編碼將不會反映在新的結構舊的中。

在檔案上設定 toolsConfig.js

下載以您 API 之 RAML 文件為基礎的 scaffold 檔案之後，您可以手動設定名為 toolsConfig.json 的 JavaScript Notation (JSON) 檔案。

Oracle Mobile Hub 使用包含自訂 API 之部署資訊的 toolsConfig.json 檔案。當您建立自訂 API 並下載 scaffold 時，會產生預設的 toolsConfig.json。若要設定 toolsConfig.json 檔案：

1. 開啟Oracle Mobile Hub中的行動後端設定值頁面
2. 請注意「設定值」頁面中的資訊。
   「設定值」頁面包含認證類型 (HTTP 基本、OAuth 用戶) 和「環境 url」等資訊。
3. 使用文字編輯器，使用Oracle Mobile Hub中「設定值」頁面的值更新 toolsConfig.json 檔案。

       "backend":{
           "backendId":"<YOUR_BACKEND_ID>",
           "backendName":"<YOUR_BACKEND_NAME>",
           "backendVersion":"<YOUR_BACKEND_VERSION>",
           "authorization":{
               "anonymousKey":"<BACKEND_ANONYMOUS_KEY>",
               "clientId":"<BACKEND_CLIENT_ID>",
               "clientSecret":"<BACKEND_CLIENT_SECRET>"
           }
       },

4. 開啟開發頁面。
5. 按一下例項詳細資料。
6. 記下小組成員應用程式從屬端 Id 和小組成員應用程式從屬端密碼值。
7. 使用這些值更新您的 toolsConfig.json 檔案。

       "tools":{
           ...,
           "authorization":{
               "clientId":"<TEAM_MEMBER_APP_CLIENT_ID>",
               "clientSecret":"<TEAM_MEMBER_APP_CLIENT_SECRET>"
           }
       },

8. (選擇性) 若要測試 toolsConfig.json 是否正確，您可以進行建置測試。開啟終端機視窗，使用下列命令瀏覽至 omce-tools 目錄並建置自訂 API：

   node omce-deploy toolsConfig.json

   執行此命令之後，系統會提示您輸入Oracle Mobile Hub 證明資料。如果您的 toolsConfig.json 檔案正確，就會顯示訊息指出 Deployment completed successfully。您可以使用此命令將來部署您的自訂 API。