Parabéns! Você finalmente terminou teu aplicativo e seu time está pronto pra shippar uma nova funcionalidade pra família Mamba! Lembre que não adianta o código rodar no seu computador, vc tem que conferir que está funcionando no seu POS!

Requisitos

Antes de começar, você precisa ter em mãos:

  • Windows ou Linux (não funciona em Mac)
  • Seu código funcionando

Build

  1. No seu projeto, vá em manifest.xml e troque os parâmetros appName, defaultName, displayedName (nome que aparecerá no launcher) para informações referentes ao seu app.
  2. Lembre-se de adicionar o ícone do seu app na pasta assets. O projeto está configurado para receber uma imagem chamada logo.svg. A imagem deverá ser quadrada (mínimo 50px x 50px). Caso você precise mudar o nome ou formato da imagem, edite também o arquivo manifest.xml onde diz: 
     <Member Name="iconPath">
 assets/icon.bmp
 </Member>
  3. No seu projeto, rodar npm run build.

    Este comando gerará uma pasta na raiz do projeto com nome dist.

Versionamento

  1. A Empresa Parceira terá um repositório git (privado) criado na conta da Stone, no padrão: “pos-mamba-3rdparty-". git
  2. Esse repositório conterá Apps desenvolvidos pelo Parceiro (homologados e publicados), com todo seu código-fonte e arquivos pertinentes (README.md, etc.).
  3. Cada aplicativo deverá estar contido em uma pasta com o sufixo “-app”.
  4. Nesse repositório existirão duas branchs master homolog Homologados, correspondendo a códigos já Publicados e respectivamente.

Homologação de Apps Privados

  1. Os pontos a seguir se aplicam a Homologação de Apps novos bem como a atualizações.
  2. Os seguintes requisitos devem ser atendidos:
    • É preciso disponibilizar uma descrição básica do do App e sua , no arquivo fluxo de funcionamento intenção de uso README.md.
    • É necessário o versionamento de código-fonte do App.
    • É necessário que sejam sinalizadas todas as dependências instruções do App, bem como a disponibilização das instruções de build.
    • Se o App utilizar comunicação por rede, é preciso listar hosts e/ou IPS utilizados, no arquivo README.md.
    • Se possível, pedimos o fornecimento de usuários e/ou chaves de testes, acesso temporário, etc. para testes das funcionalidades do APP durante o processo de Homologação.
  3. Um “Pedido de Homologação de Aplicação” corresponderá a um Pull Request (PR) à branch homolog, com todas as alterações a serem validadas.
  4. A aprovação de um PR à corresponderá ao aceite (Homologação) do código proposto.
  5. Apenas versões Homologadas de Apps estarão disponíveis para serem Publicadas.

Homologação de Apps Públicos

  1. A Ser Definida

Publicação

  1. A Publicação de Apps na Mamba Store será feita a critério do Parceiro. Apps poderão ser publicados logo que Homologados ou em um momento futuro, definido pelo Parceiro.
  2. Um “Pedido de Publicação de Aplicação” corresponderá a um Pull Request (PR) .
  3. A aprovação de um PR à branch homolog corresponderá à Publicação, na Mamba Store, do App Homologado.
  4. Apps poderão ser publicados na Mamba Store de forma Pública ou Privada, sendo sua visualização restrita por StoneCode (SC):
    • Apps Privados só estarão disponíveis para download para POS ativados com o SC do Parceiro.
    • Apps Públicos poderão ser restritos a alguns SC ou disponibilizados a toda a base da Stone.
  5. Todos os Apps Homologados poderão ser Publicados de forma Privada.
  6. Apenas Apps que atendam aos critérios de Homologação de Apps Públicos poderão ser Publicados dessa forma. (Critérios ainda sem definição)

SOCORRO

O tutorial não funcionou? Procure-nos em nosso canal do Slack.