Instalar e Configurar o Oracle Mobile Hub Tooling para Implantar APIs Personalizadas

Você pode fazer download e configurar ferramentas adicionais para implantar APIs personalizadas no Oracle Mobile Hub.

Instale a Ferramenta Node.js

Ao fazer download do SDK da OTN (Oracle Technology Network), você tem a opção de fazer download do arquivo omce-tools-vXX.X.X, que inclui um script Node.js que pode ser usado para implantar seus aplicativos no Oracle Mobile Hub

Para instalar o conjunto de ferramentas Node.js no seu projeto:

Faça download do arquivo zip omce-tools-vXX.X.X e descompacte o arquivo Zip em um diretório
Na sua máquina, abra uma janela de terminal (Pode ser necessário executar esse comando como um usuário admin) e, em seguida, altere para o diretório omce-tools/node-configurations.
Determine a configuração do Nó que você precisa usar para a API personalizada que você está testando. Use 6.10 para o Node versão 6.10.0 ou compatível e use 8.9 para o Node versão 8.9.4 ou compatível. A configuração do Nó padrão do Oracle Mobile Hub é 8.9.
Mude para o diretório da configuração do nó que você deseja usar: '6.10` ou `8.9`
Execute o seguinte comando:
```
npm install
```
Altere para o diretório omce-tools.
Execute o comando:
```
npm install -g
```
Este comando disponibiliza a ferramenta globalmente no seu ambiente local. É necessário ter o Node.js e o gerenciador de pacotes npm instalado antes de executar este comando
Defina a variável de ambiente NODE_PATH para o diretório node_modules para a configuração de nó que deseja usar ou para path/omce-tools/node-configurations/8.9/node_modules.
Para testar se a instalação foi bem-sucedida, execute o comando:
```
omce-test --version
```

Fazer download de um Scaffold JavaScript para uma API Personalizada

Depois de criar sua API personalizada, você pode fazer download de uma scaffold baseada no documento RAML da sua API e, em seguida, usar a scaffold como um início rápido para implementar sua API personalizada.

O scaffold vem na forma de módulo de Nó, os componentes-chave dos quais são o arquivo JavaScript principal que contém métodos stub para cada ponto final (método de recurso mais HTTP) e um arquivo package.json, que serve como manifesto do módulo.

Para fazer download do scaffold:

Clique em para abrir o menu lateral, clique em Desenvolvimento e, em seguida, clique em APIs.
Abra a API da qual você deseja fazer download.
Na área de navegação à esquerda do API Designer, clique em Implementações .
Clique em JavaScript Scaffold para fazer download do arquivo zip.
No sistema, descompacte o arquivo obtido por download.

Se posteriormente você alterar a API, poderá fazer download de um novo scaffold com base nos pontos finais atualizados. No entanto, qualquer codificação que você tenha feito e feito upload anteriormente não será refletida no novo scaffold.

Configurar a toolsConfig.jsno Arquivo

Depois de fazer download de um arquivo scaffold que seja baseado no documento RAML da API, você pode configurar manualmente um arquivo JSON (JavaScript Notation) chamado toolsConfig.json.

O Oracle Mobile Hub usa um arquivo toolsConfig.json que contém as informações de implantação para uma API personalizada. Um toolsConfig.json default é gerado quando você cria uma API personalizada e faz download do scaffold. Para configurar o arquivo toolsConfig.json:

Abra a página Definições de backend móvel no Oracle Mobile Hub
Observe as informações na página Definições .
A página Definições contém informações como os tipos de autenticação (HTTP Basic, OAuth Consumer) e os URLs do Ambiente.

Usando um editor de texto, atualize o arquivo toolsConfig.json com os valores da página Definições no Oracle Mobile Hub.

    "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>"
        }
    },

Abra a página Desenvolvimento .
Clique em Detalhes da Instância.
Observe os valores de Id do Cliente do Aplicativo do Membro da Equipe e Segredo do Cliente do Aplicativo do Membro da Equipe.

Atualize seu arquivo toolsConfig.json com esses valores.

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

(Opcional) Para testar se o toolsConfig.json está correto, é possível realizar um teste de implantação. Abra uma janela de terminal, navegue até o diretório omce-tools e implante a API personalizada usando o comando:
```
node omce-deploy toolsConfig.json
```
Após executar este comando, você será solicitado a fornecer as credenciais do Oracle Mobile Hub. Se o arquivo toolsConfig.json estiver correto, será exibida uma mensagem informando Deployment completed successfully. Você pode usar esse comando para implantar sua API personalizada no futuro.