Neste artigo, irá aprender a utilizar o TSE da Swissbit no Android numa implementação nuget.

Para utilizar o hardware TSE da Swissbit com a ajuda do serviço REST (atualmente ainda não disponível), deve ter em conta outros aspetos.

Preparação

Irá necessitar do seguinte:

• pacote nuget RetailForce. Fiscalisation V1.2.8 (beta) ou superior
• Implementação Swissbit para Android (DLL) SwissbitAndroid.dll
  Disponível em www.retailforce.cloud/downloads na respetiva versão (a partir da 1.2.8) na secção de implementação
• Ambiente Xamarin .NET
• Competências de desenvolvimento em .NET 
• Competências de desenvolvimento em Xamarin e Android

Sistemas operativos de destino (Android)

• Atualmente, são suportadas as versões Android 9 a 10.
• Está a ser trabalhado o suporte ao Android 11 (correção de erros do Google)

Reinicialização do TSE 

Também é possível reiniciar o TSE utilizando o Android (apenas para TSEs de desenvolvimento). Isto pode ser feito programaticamente:

WormStore swissbitTse = WormStoreAndroidCompat.CreateWormStore(Application.Context);
swissbitTse.Tse_factoryReset();

O Application.Context está disponível, por exemplo, na MainActivity de uma aplicação Xamarin.

Definições no Android

Montagem do cartão Swissbit-micro-sd

Pode acontecer, ocasionalmente, que o cartão Swissbit não esteja corretamente montado (disponibilizado). Nesse caso, não terá acesso a este cartão. Se for essa a situação, retire o cartão em «Definições/Memória» e volte a montá-lo.

Acesso aos ficheiros do hardware TSE de Swissbit

A comunicação com o hardware TSE da Swissbit é feita através de comunicação de ficheiros; por isso, recomenda-se que efetue as seguintes configurações na aplicação:

• No Android Manifest, é necessário
  
  • READ_EXTERNAL_STORAGE
  • WRITE_EXTERNAL_STORAGE
• a partir do Android 10:

  android:requestLegacyExternalStorage="true"

Estão também disponíveis mais informações em: https://developer.android.com/training/data-storage/use-cases.

Notas de implementação

A implementação do ambiente de fiscalização é efetuada através do nuget, conforme descrito acima.

Após adicionar o pacote nuget «RetailForce.Fiscalisation», a implementação pode ser realizada tal como numa implementação padrão do nuget.  

Poderá encontrar conselhos gerais sobre a implementação do nuget no seguinte artigo: Primeiros passos na implementação do nuget.

Para utilizar o Swissbit TSE no Android, deve executar os seguintes comandos, para além da implementação padrão do nuget:

FiscalModulCreator.ObjectCache.Add(SwissbitAndroidCommunication.CONTEXT_OBJECT_CACHE_IDENTIFIER, new SwissbitContextCreator());
FiscalModulCreator.ObjectCache.Add(SwissbitHardware.CREATOR_OBJECT_CACHE_IDENTIFIER, new SwissbitAndroidCreator());

Este artigo foi traduzido automaticamente.