cloudbridge-cli



Ferrramenta para linha de comando CloudBridge

``bash
$ npm install -g cloudbridge
`

Pré Requisitos
- NodeJS >= 6.0.0
- Git
- JDK 1.8
- Setar a variável de ambiente JAVA_HOME apontando para o JDK

Para android
- Android SDK
- Build Tools >= 24
- JDK 1.8
- Setar a variável de ambiente ANDROID_HOME apontando para o SDK

Para iOS
- MacOS X. Testado no 10.11 El Captain, 10.12 Sierra, iOS9 e iOS 10
- XCode >= 8
- Certificado de desenvolvimento iOS válido ja instalado
- ios-deploy (npm install -g ios-deploy)
- Python >= 2.7
- Six module for Python (easy_install six)




$3

Existem 3 tipos de projeto, FatClient, Cordova based e Ionic based.

$3

O projeto FatClient utiliza o SmartClient (baseado em Qt) para controlar o dispositivo
`bash
$ cb start MyApp -t showcase
`

Templates disponíveis: base, showcase
Após a criação, não esquecer de entrar no diretório do projeto

`bash
$ cd MyApp
`

$3


O projeto Cordova utiliza apenas o AppServer (para ADVPL). A Interface é toda construída compatível com o Cordova (https://cordova.apache.org/), podendo utilizar os plugins já disponíveis.
Antes de começar é necessário ter o NPM do cordova já disponível (npm install -g cordova).
`bash
$ cb start MyApp --cordova
`

Após a criação, não esquecer de entrar no diretório do projeto

`bash
$ cd MyApp
`

$3

Assim como com o Cordova, o projeto utiliza apenas o AppServer (para ADVPL). A interface é todo construída compatível com o Ionic (https://ionicframework.com/).
Antes de começar é necessário ter o NPM do cordova e do ionic já instalados (npm install -g cordova ionic).
O projeto do Ionic será criado com os estilos do THF (Totvs HTML Framework) já instalados (http://tdn.totvs.com/display/THF/TOTVS+%7C+HTML+Framework).

`bash
$ cb start MyApp --ionic
`

Após a criação, não esquecer de entrar no diretório do projeto

`bash
$ cd MyApp
`

$3

Plataforms disponíveis:
*Windows
*Linux
*OSX
*Android
*IOS

`bash
$ cb platform add windows
$ cb platform add android
`

ou

`bash
$ cb platform add windows android
`

Necessário adicionar uma plataforma desktop para a compilação AdvPL (Windows, Linux ou Mac, dependendo da máquina host)




$3

`bash
$ cb build windows
$ cb run windows

$ cb build android
$ cb run android
`

$3

`bash
$ cb bower add jquery
$ cb bower add angular#1.2.0
$ cb bower remove jquery
``

$3

A utilização de plugins do projeto Cordova deve seguir as mesmas diretrizes já existentes:
https://cordova.apache.org/plugins/

$3

Consulte a documentação do CloudBridge no TDN

$3

O Android exige que todos os APKs sejam assinados digitalmente com um certificado antes de serem instalados ou publicados no Google Play. Este guia do desenvolvedor Android contém informações detalhadas sobre a assinatura de aplicativos.

Resumidamente siga os seguintes passos:
- Gere uma chave privada usando o Android Studio ou mesmo pela linha de comando através da ferramenta keytool conforme este guia.
- Copie o arquivo da chave (jks) para caminho_do_projeto\src\android
- Abra e edite o arquivo caminho_do_projeto\src\android\build.gradle e insira as informações sobre a chave privada conforme estas instruções.
- Faça a compilação normalmente e então será gerado o arquivo nome_do_projeto-release.apk em caminho_do_projeto\build

$3

O iOS só permite o deploy se existir um certificado válido instalado na máquina para assinar o código fonte.
Code Signing

Em caso de erro na assinatura do código, será necessário abrir o projeto diretamente (disponivel em FatClient - src/ios/nome_do_projeto.xcodeproj Cordova - platforms/ios/HelloCordova.xcodeproj Ionic - platforms/ios/MyApp.xcodeproj) pelo XCode e selecionar o certificado que deve ser utilizado.

Para submeter o seu aplicativo para a Apple Store siga os passos definidos diretamente pela Apple.
Seus Apps na App Store

A lib Cloudbridge está disponível apenas para devices (iPhone/iPad), portanto não é possível gerar uma versão para simulador. Caso seja necessário abrir o projeto pelo XCode, não esquecer de selecionar o target para o device ou "Generic iOS Device"