安装和配置用于部署定制 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 zip 文件并将 Zip 文件解压缩到目录中
2. 在计算机上，打开一个终端窗口（可能需要以管理员用户身份运行此命令），然后更改为 omce-tools/node-configurations 目录。
3. 确定需要用于所测试的定制 API 的节点配置。对节点版本 6.10.0 使用6.10或兼容 , 并对节点版本 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 作为实施定制 API 的快速入门。

Scaffold 附带有节点模块的形式，这些关键组件是包含每个端点的存根方法（资源加上 HTTP 方法）的主 JavaScript 文件，以及一个 package.json 文件，该文件用作模块的清单。

要下载 scaffold，请执行以下操作：

1. 单击 以打开侧边菜单，单击开发 ，然后单击 api。
2. 打开要下载的 API。
3. 在 API 设计器的左侧导航区域中，单击实施。
4. 单击 JavaScript Scaffold 以下载 zip 文件。
5. 在系统上，解压缩下载的文件。

如果以后更改了 API，则可以下载基于更新的端点的新认证。但是，您以前可能已经完成并上载的任何编码都不会反映在新的基础上。

在文件上配置 toolsConfig.js

下载基于 API RAML 文档的 scaffold 文件后，可手动配置名为 toolsConfig.json 的 JavaScript 表示法(JSON)文件。

Oracle Mobile Hub 使用包含定制 API 的部署信息的 toolsConfig.json 文件。当您创建定制 API 并下载基架时会生成默认 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。