Od verzije 1.11.2 nadalje, RetailForce servis za fiskalizaciju ('middleware') bit će dostupan i kao nativni servis za Android.

Android servis možete pronaći u odjeljku za preuzimanje na web stranici RetailForce za odgovarajuću verziju (retailforce.trustedfiscalmodule-Signed.apk).

Instalacija

Da biste instalirali Android servis, preuzmite ga na odgovarajući uređaj. Da biste instalirali servis, morate postaviti dozvolu za instalaciju ('Vjerujte ovom izvoru').

Nakon instalacije, servis se pokreće automatski.

Također možete distribuirati APK datoteku putem MDM (Mobile Device Management) sistema.

Integracija

RetailForce servis za fiskalizaciju za Android radi kao servis u prvom planu.

Da bi se aplikacija povezala na RetailForce servis za Android, mora izvršiti sljedeće korake:

• Dozvole u AndroidManifest.xml

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

• Pozovite RetailForce servis za Android (primjer za C#, ali slično i za 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);
}
```

• Povežite se na RetailForce servis za 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");
}
```

• Zatražite dozvolu.

Možda će biti potrebno zatražiti dozvolu za pozivanje pozadinske usluge (od Androida 13).

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

RetailForce servis za Android radi na adresi http://127.0.0.1:7678/api/v1/ i može se koristiti putem REST-a (baš kao i RetailForce REST servis za fiskalizaciju na Windows, Docker ili Cloud servis za fiskalizaciju).

Različite verzije Androida

Trenutno je servis RetailForce za Android testiran samo na Androidu 14 i 15.

Za starije verzije Androida, možda će biti potrebno malo prilagoditi kod, posebno u pogledu dozvola i povezivanja usluge.

Rješavanje problema

Za provjeru opće funkcije middlewarea ili za rukovanje greškama, može biti korisno koristiti alat naredbenog retka 'Android Debug Bridge (ADB)', npr. na Windowsu.

Da biste to uradili, ADB za Windows mora biti dostupan u direktoriju na vašem računaru.

• Povežite Android uređaj na Windows PC putem USB-a,
• otvorite komandnu liniju u ADB direktoriju,
• i unesite sljedeću naredbu:

adb logcat "RetailForceService:D *:S"

Ova komanda prikazuje sve zapise u dnevniku onako kako biste ih obično pronašli u datotekama dnevnika Windows ili Docker servisa.

Ovaj članak je automatski preveden.