# Configuração do ambiente

Este tutorial orienta você através dos requisitos técnicos e procedimentos iniciais para configurar seu ambiente de desenvolvimento e conectar o terminal **Newland N750P**.

## Requisitos Técnicos

Antes de iniciar a instalação, certifique-se de ter os seguintes componentes de hardware e software disponíveis:

* **Terminal**: Newland N750P.
* **Cabos**: Cabo multi-portas incluindo POWER, USB-A, RJ-45 e HDMI.
* **Fonte de Alimentação**: 100-240V AC 50/60Hz para 9.0V DC, 2.5A.
* **Sistema Operacional**: NDroid6 baseado em Android 12.
* **IDE de Desenvolvimento**: Android Studio 2023.2.1 Iguana.
* **Configuração da Porta Serial**: **115200, 8, N, 1** (115200 baud rate, 8 bits de dados, sem paridade, 1 stop bit).

## Conexão de Hardware e Inicialização

Siga estas etapas específicas para ligar e conectar seu terminal corretamente. O gerenciamento adequado dos cabos é essencial para a estabilidade do sistema.

1. Conecte o conector HDMI do cabo multi-portas na parte traseira do terminal N750P.
2. Conecte a porta **POWER** do cabo à fonte de alimentação fornecida.
3. O dispositivo ligará automaticamente assim que a fonte de energia for conectada.
4. Estabeleça a comunicação com base no seu ambiente atual:
   * **Ambiente de Produção**: Use a **porta USB Tipo-A** para estabelecer o link de dados entre o terminal e o PC.
   * **Desenvolvimento/Depuração**: Conecte um **cabo USB Tipo-C** diretamente ao terminal para instalação de aplicativos e depuração de código.

> **Aviso de Segurança**: Não conecte os cabos USB Tipo-A e USB Tipo-C ao mesmo tempo. O dispositivo deve ser ligado apenas com o cabo de dados único pretendido conectado.

## Modo Desenvolvedor e Verificação

Antes de tentar sincronizar com o Android Studio, você deve garantir que o terminal esteja preparado para depuração:

* **Pré-requisito**: O dispositivo deve ter o **Modo Desenvolvedor ativado** para ser reconhecido pela IDE via USB Tipo-C.
* **Verificação**: Verifique o visor do dispositivo quanto à marca d'água **"DEVELOPMENT ONLY"**. Se estiver visível, o terminal está pronto para uso em desenvolvimento.

## Configuração do Projeto no Android Studio

Assim que o hardware estiver conectado e verificado, prepare o projeto dentro da IDE:

1. Inicie o Android Studio e selecione **File > Open**.
2. Navegue até a pasta raiz do projeto e clique em **OK**.
3. **Sincronização do Gradle**: Aguarde o Android Studio terminar o processo de sincronização. Se a IDE solicitar a atualização de plugins ou dependências, **aceite as recomendações**. O ambiente só estará "pronto" quando a sincronização terminar e a estrutura do projeto estiver totalmente visível.
4. Conecte o terminal à sua estação de trabalho via USB Tipo-C.
5. Verifique se o dispositivo é reconhecido na barra de seleção na parte superior da IDE; ele deve aparecer como **"newland N750P"**.

## Compilando e Executando o Projeto

Com o ambiente pronto e o terminal reconhecido:

1. Certifique-se de que o módulo **"app"** esteja selecionado no menu suspenso de configurações de execução.
2. Clique no ícone **Run 'app'** ou pressione **Shift + F10**.
3. O Android Studio compilará, instalará e lançará o aplicativo no terminal automaticamente.

## Gerando o APK de Instalação

Para produzir um APK autônomo para distribuição ou teste:

1. Selecione **Build > Clean Project**. Isso exclui especificamente todos os arquivos no diretório `outputs` para garantir uma nova compilação.
2. Selecione **Build > Rebuild Project** para compilar o aplicativo do zero.
3. Selecione **Build > Build Bundle(s) / APK(s) > Build APK(s)**.
4. Quando a compilação terminar, clique em **locate** na notificação pop-up para abrir a pasta de destino.

## Próximos Passos

Com seu ambiente configurado com sucesso e o terminal conectado, você pode prosseguir para as seguintes seções:

1. [**Configuração & Conectividade**](https://docs.globalgetnet.com/pt/products/in-store-payments/host-to-host?doc=h2h-configuration-and-connectivity\&section=qhv6nzspm4fa7zajc43yr3ka): Execute seu primeiro teste de comunicação usando o comando **Echo Request (Y0I)**.
2. [**Arquitetura & Conceitos Principais**](https://docs.globalgetnet.com/pt/products/in-store-payments/host-to-host?doc=h2h-system-architecture\&section=qkgon7kvze04x46w47u75f1n): Entenda os módulos internos de software e os procedimentos de manuseio seguro de dados antes de iniciar a integração completa.