W niniejszym artykule dowiedzą się Państwo, jak korzystać z modułu TSE firmy Swissbit na systemie Android w ramach implementacji nuget.

W przypadku korzystania ze sprzętowego modułu hardware TSE firmy Swissbit za pośrednictwem usługi REST (obecnie jeszcze niedostępnej) należy uwzględnić inne kwestie.

Przygotowanie

Potrzebne będą następujące elementy:

• pakiet NuGet RetailForce.Fiscalisation w wersji 1.2.8 (beta) lub nowszej
• Implementacja Swissbit dla systemu Android (plik DLL) SwissbitAndroid.dll
  Dostępna na stronie www.retailforce.cloud/downloads w odpowiedniej wersji (od 1.2.8) w sekcji „Implementacja”
• Środowisko Xamarin .NET
• Umiejętności programistyczne w środowisku .NET 
• Umiejętności programistyczne w Xamarin i systemie Android

Docelowe systemy operacyjne (Android)

• Obecnie obsługiwane są wersje Androida od 9 do 10.
• Trwają prace nad obsługą systemu Android 11 (poprawka błędu Google)

Resetowanie modułu TSE 

Resetowanie modułu TSE jest również możliwe w systemie Android (tylko w przypadku modułów TSE typu DEV). Można to zrealizować programowo:

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

Obiekt Application.Context jest dostępny na przykład w klasie MainActivity aplikacji Xamarin.

Ustawienia w systemie Android

Montowanie karty Swissbit-micro-sd

Od czasu do czasu może się zdarzyć, że karta Swissbit nie zostanie poprawnie zamontowana (udostępniona). Wówczas nie ma Pan/Pani dostępu do tej karty. W takim przypadku należy wysunąć kartę w menu Ustawienia/Pamięć, a następnie zamontować ją ponownie.

Dostęp do plików w sprzętowym module hardware TSE firmy Swissbit

Komunikacja z urządzeniem Swissbit hardware TSE odbywa się za pośrednictwem komunikacji plikowej, dlatego zaleca się wprowadzenie następujących ustawień w aplikacji:

• W pliku manifestu systemu Android należy wprowadzić następujące ustawienia
  
  • READ_EXTERNAL_STORAGE
  • WRITE_EXTERNAL_STORAGE
• od wersji Android 10:

  android:requestLegacyExternalStorage="true"

Więcej informacji można również znaleźć pod adresem: https://developer.android.com/training/data-storage/use-cases.

Uwagi dotyczące wdrożenia

Wdrożenie środowiska fiskalnego odbywa się za pośrednictwem pakietu nuget, zgodnie z powyższym opisem.

Po dodaniu pakietu nuget RetailForce.Fiscalisation wdrożenie można przeprowadzić tak samo, jak w przypadku standardowego wdrożenia z wykorzystaniem nuget.  

Ogólne wskazówki dotyczące wdrażania za pomocą nuget można znaleźć w następującym artykule: Pierwsze kroki we wdrażaniu za pomocą nuget.

Aby korzystać z Swissbit TSE w systemie Android, oprócz standardowej implementacji za pomocą nuget należy wykonać następujące polecenia:

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

Ten artykuł został przetłumaczony automatycznie.