Configurar o aplicativo POS Hybrid no Android e iOS
Este artigo mostra como construir e executar a aplicativo híbrido Retail POS (Retail de ponto de venda) em dispositivos Android e iOS.
Observação
Os aplicativos Retail Hybrid estão sendo substituídos pelos aplicativos do Store Commerce para Android e iOS. Para obter mais informações, consulte o aplicativo do Store Commerce para plataformas móveis.
O aplicativo híbrido Retail é um shell criado usando Xamarin. Dentro do Shell está um controlador de exibição da Web que carrega o CPOS (Cloud POS), que se baseia na URL da Commerce Scale Unit especificada nas configurações deste aplicativo. O Shell do aplicativo Retail híbrido é para Android e iOS, que irá carregar CPOs internamente. Para obter mais informações, consulte PDV em nuvem.
Os aplicativos Store Commerce para Microsoft Windows e plataformas móveis são a próxima geração de aplicativos PDV para Dynamics 365 Commerce. O PDV moderno (MPOS) e o aplicativo Retail híbrido serão preteridos em outubro de 2023. A Microsoft recomenda usar o Store Commerce ou o PDV em nuvem (CPOS) para todas as novas implantações de PDV. Os clientes existentes devem planejar a migração do aplicativo Retail híbrido e MPOS para o Store Commerce.
Ferramentas de desenvolvimento
O aplicativo Retail híbrido oferece suporte às plataformas móveis Android e iOS. O aplicativo é criado usando Xamarin, o que significa que você deve instalar o Xamarin no seu computador de desenvolvimento. Para criar o aplicativo iOS, você deve ter um Mac com o Xamarin instalado. Embora seja possível fazer o desenvolvimento para os dois Android e iOS em um computador que executa o Microsoft Windows, você deve usar um Mac para concluir a compilação da plataforma iOS. Se o seu Mac é um recurso de equipe compartilhado, você pode desejar usar um Mac somente para o processo de compilação. Você deve copiar o kit de desenvolvimento do software do Retail (SDK do Retail) em todos os computadores que você usa para desenvolvimento. O SDK do Retail está disponível em todas as VMs de desenvolvedor provisionadas para o uso Microsoft Dynamics de Lifecycle Services (LCs).
Para obter mais informações sobre o Xamarin, consulte a documentação do Xamarin.
Configurar e instalar o Xamarin no Windows
Para configurar e instalar o Xamarin no Windows, vá para instalação do Windows.
Atualizar o Xamarin
Observação
É recomendável usar Xamarin.Android SDK, versão < 10,0.
Depois de instalar o Xamarin, você deve atualizá-lo para a última versão estável (Xamarin.Android, a versão do SDK deve ser < 10,0).
- Windows: no Microsoft Visual Studio, selecione Ferramentas > Opções > Ambiente > Xamarin > Outro.
- Mac: no Xamarin Studio, selecione Verificar se há atualizações > Atualizar canal. Para obter mais informações sobre essa etapa, consulte Alterar os canais de atualizações.
Construir o aplicativo Retail híbrido de Android
Observação
Recomendamos que você use o Visual Studio 2019 ou posterior para criar o aplicativo Android.
Para instalar o aplicativo Retail híbrido para Android, siga estas etapas:
Quando a instalação for concluída, abra o Visual Studio e faça login usando sua conta Microsoft (a mesma conta que você usa com o Windows). Verifique se há atualizações do Xamarin, selecionando Ferramentas > Opções > Xamarin ou Ferramentas > Opções > Xamarin > Outros Você verá um link com a opção Verificar agora. Se você não vir uma opção para Xamarin em Ferramentas > Opções, revise sua instalação ou tente fechar e reabrir o Visual Studio. Você também pode procurar o Xamarin na caixa de diálogo Opções. Faça o download e instale a versão mais recente, conforme necessário.
Na pasta SDK do Retail, abra SampleExtensions\HybridApp\Android\Sample.HybridApp.Android.sln. Crie e implante usando o emulador e verifique se tudo é exibido como deveria.
Observação
Se você deseja adicionar uma URL de host personalizada do Azure Active Directory (Azure AD) para ativação, na solução edite o arquivo PosActivity.cs , procure a variável matriz de cadeia de caracteres chamada AadHostUrlse, em seguida, adicione a URL do host personalizado Azure AD à matriz.
Usando o Visual Studio emulador para Android ou qualquer emulador do Android, inicie o aplicativo PDV híbrido e insira a URL da Commerce Scale Unit e salve.
Você deve ser capaz de entrar e ativar o dispositivo.
Configurar o aplicativo Retail híbrido de iOS
Conectar ao Mac
Se você estiver programando no Windows e usando um Mac apenas para configurar o aplicativo iOS, deverá conectar o computador que executa o Windows com o Mac. Para obter instruções, consulte conectando-se ao Mac.
Configurar e instalar o Xamarin no iOS
Para configurar e instalar o Xamarin no iOS, siga estas etapas.
- Faça o download e instale o Xcode a partir do https://developer.apple.com/xcode/. Adicione sua ID Apple seguindo as instruções em adicionando sua conta ao Xcode (apple.com).
- Faça o download e instale o Xamarin seguindo as instruções em instalando e configurando o Xamarin.iOS (xamarin.com).
- Ao concluir a instalação do Xamarin no computador com o Windows e no Mac, siga as instruções em conectando-se ao Mac (xamarin.com). Depois de conectar-se ao Mac, você pode trabalhar com o iOS e o Mac no computador com o Visual Studio no Windows.
Para obter mais informações sobre como instalar o Xamarin no iOS, consulte Xamarin.iOS, instalação.
Configurar o aplicativo Retail híbrido de iOS
Na pasta SDK do Retail, abra SampleExtensions\HybridApp\iOS\solução. Depois de se conectar ao Mac e criar o aplicativo no Visual Studio, selecione o tipo de dispositivo iOS e implante o aplicativo no dispositivo selecionado.
No emulador, vá para Configurações > Retail Modern POS e insira a URL da Commerce Scale Unit.
Abra o aplicativo MPOS. Agora você deve ser capaz de entrar e ativar o dispositivo.
Assinatura e distribuição híbridas de aplicativos
Para assinar e distribuir o aplicativo Android e iOS , consulte as seguintes opções:
Android
iOS
Suporte a estação de hardware dedicado para o aplicativo híbrido Android
Iniciando na versão 8.1.3, o suporte a estação de hardware dedicado foi adicionado ao aplicativo híbrido Android . Da mesma forma que a Retail Modern POS tem suporte interno a dispositivos periféricos, o aplicativo Android também pode usar a estação de hardware dedicada para conectar-se a periféricos sem precisar implantar uma estação de hardware baseada no IIS. A partir da caixa, o aplicativo híbrido para Android oferece suporte ao uso de terminais de pagamento e impressoras de recibo em conexões de rede. A comunicação com dispositivos em uma rede normalmente requer a adesão a um protocolo de comunicação proprietário especificado pelo fabricante. Para o aplicativo híbrido para Android, as integrações imediatas são fornecidas para o conector de pagamento do Dynamics 365 para impressoras de recibo Adyen e Epson.
Dispositivos compatíveis prontos para uso
| Dispositivo | descrição |
|---|---|
| Terminais de pagamento | Qualquer suporte da API para terminal de pagamento Adyen por meio do conector de pagamento Dynamics 365 para Adyen. |
| Impressora de recibo | Impressoras Epson habilitadas para rede que suportam a interface HTTP da Epson SOAP. Impressoras Star Micronics habilitadas para rede. |
| Caixa registradora | Introduzido na Dynamics 365 Commerce versão 10.0.8: gavetas de caixa conectadas a impressoras habilitadas pela rede por meio da porta de lançamento da gaveta (d/k). |
O suporte para outros processadores de pagamento e periféricos pode ser implementado por ISVs por meio de pagamentos e SDKs de hardware.
Configurar periféricos para trabalhar com o aplicativo híbrido Android
Para habilitar o suporte de hardware direto para o aplicativo híbrido Android, configure uma estação de hardware dedicada da mesma forma que será configurada para os MPOs. Instruções para configurar a estação de hardware dedicada, ou IPC, podem ser encontradas em periféricos do Retail
Observação
A estação de hardware dedicada que inclui dados de demonstração não deve ser usada com o aplicativo híbrido Android. Para testar o aplicativo híbrido Android em um ambiente que contém dados de demonstração, exclua as estações de hardware existentes e crie uma nova estação de hardware dedicada. Acesse Retail e Commerce > Canais > Lojas > Todas as lojas, selecione a loja que será utilizada (geralmente HOUSTON). Na página detalhes do armazenamento, na guia de iniciação rápida de estações de Hardware, remova a estação de hardware dedicada existente e, em seguida, selecione Adicionar para adicionar uma nova estação de hardware do tipo Dedicado. Uma descrição é opcional. Nenhum outro detalhe é necessário para a estação de hardware.
Para configurar o conector de pagamento, siga as etapas padrão de configuração presentes em Conector de Pagamento do Dynamics 365 para Adyen. Ignore a seção "Atualizar a configuração do PDV moderno ou da estação de hardware do IIS".
Para obter detalhes sobre como configurar periféricos conectados na rede, consulte os documentos Suporte para periféricos de rede.