Începând cu release-ul 1.11.2, serviciul de fiscalizare RetailForce („middleware”) va fi disponibil și ca serviciu nativ pentru Android.

Puteți găsi serviciul pentru Android în secțiunea de descărcări a RetailForce website, pentru versiunea respectivă (retailforce.TrustedFiscalModule-Signed.apk).

Instalare

Pentru a instala serviciul pentru Android, descărcați-l pe dispozitivul corespunzător. Pentru a instala serviciul, trebuie să setați permisiunea de instalare („Aveți încredere în această sursă”).

După instalare, serviciul pornește automat.

De asemenea, puteți distribui fișierul APK prin intermediul unui sistem MDM (Mobile Device Management).

Integrare

Serviciul de fiscalizare RetailForce pentru Android rulează ca serviciu în prim-plan.

Pentru a se conecta la serviciul RetailForce pentru Android, aplicația trebuie să parcurgă următorii pași:

• Permisiuni în AndroidManifest.xml

``` xml
<uses-permission android:name="cloud.retailforce.trustedfiscalmodule.RetailForceService.BIND_RETAILFORCE" />
<queries>
	<package android:name="cloud.retailforce.trustedfiscalmodule" />
</queries>
```

• Apelați serviciul RetailForce pentru Android (exemplu pentru C#, dar similar în Java / Kotlin)

``` csharp
var intent = new Intent();
ComponentName componentName = new ComponentName("cloud.retailforce.trustedfiscalmodule", "cloud.retailforce.trustedfiscalmodule.RetailForceService");
intent.SetComponent(componentName);

if (Build.VERSION.SdkInt >= BuildVersionCodes.O)
{
    StartForegroundService(intent);
}
else
{
    StartService(intent);
}
```

• Conectarea la serviciul RetailForce pentru Android

``` csharp
ServiceConnection serviceConnection = new ServiceConnection();

if (!BindService(intent, serviceConnection, Android.Content.Bind.AutoCreate | Android.Content.Bind.AllowActivityStarts))
{
    _logger.LogInformation("Bind service failed");
    throw new Exception("Could not bind RetailForceService");
}
```

• Solicitarea permisiunii.

Ar putea fi necesar să se solicite permisiunea de a apela un serviciu în prim-plan (începând cu Android 13).

``` csharp
if (Build.VERSION.SdkInt >= BuildVersionCodes.Tiramisu)
{
    if (CheckSelfPermission(Android.Manifest.Permission.ForegroundService) != Permission.Granted)
    {
        RequestPermissions(new[] { Android.Manifest.Permission.ForegroundService }, 101);
    }
}
```

Serviciul RetailForce pentru Android rulează la adresa http://127.0.0.1:7678/api/v1/ și poate fi accesat prin REST (la fel ca serviciul REST RetailForce Fiscalisation pe Windows, Docker sau Cloud Fiscalisation Service).

Diferite versiuni de Android

În prezent, serviciul RetailForce pentru Android a fost testat doar pe Android 14 și 15.

Pentru versiunile mai vechi de Android, poate fi necesar să ajustați ușor codul, în special în ceea ce privește permisiunile și legarea serviciului.

Depanare

Pentru a verifica funcționarea generală a middleware-ului sau pentru gestionarea erorilor, poate fi utilă utilizarea instrumentului de linie de comandă „Android Debug Bridge (ADB)”, de exemplu pe Windows.

Pentru aceasta, ADB pentru Windows trebuie să fie disponibil într-un director de pe computerul dumneavoastră.

• Conectați dispozitivul Android la PC-ul cu Windows prin USB,
• deschideți o fereastră de comandă în directorul ADB,
• și introduceți următoarea comandă:

adb logcat "RetailForceService:D *:S"

Această comandă afișează toate intrările din jurnal așa cum le-ați găsi în mod normal în fișierele de jurnal ale serviciului Windows sau Docker.

Acest articol a fost tradus automat.