Od release 1.11.2 naprej bo storitev RetailForce Fiscalisation Service („middleware“) na voljo tudi kot nativna storitev za Android.

Storitev za Android lahko najdete v razdelku za prenose na RetailForce website za zadevno različico (retailforce.TrustedFiscalModule-Signed.apk).

Namestitev

Za namestitev storitve za Android jo prenesite na ustrezno napravo. Za namestitev storitve morate nastaviti dovoljenje za namestitev („Zaupaj temu viru“).

Po namestitvi se storitev zažene samodejno.

Datoteko APK lahko distribuirate tudi prek sistema MDM (Mobile Device Management).

Integracija

Storitev RetailForce Fiscalisation za Android deluje kot storitev v ospredju.

Za povezavo s storitvijo RetailForce za Android mora aplikacija izvesti naslednje korake:

• Dovoljenja v datoteki AndroidManifest.xml

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

• Pokličite storitev RetailForce za Android (primer za C#, vendar podobno v Javi / Kotlinu)

``` 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);
}
```

• Povezava s storitvijo RetailForce 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");
}
```

• Zahteva za dovoljenje.

Morda bo treba zaprositi za dovoljenje za klic storitve v ospredju (od Android 13 naprej).

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

Storitev RetailForce za Android deluje na naslovu http://127.0.0.1:7678/api/v1/ in je dostopna prek REST (tako kot storitev RetailForce Fiscalisation REST v sistemu Windows, Dockerju ali storitvi Cloud Fiscalisation).

Različne različice Androida

Trenutno je bila storitev RetailForce za Android preizkušena le na Androidu 14 in 15.

Za starejše različice Androida bo morda treba kodo nekoliko prilagoditi, zlasti kar zadeva dovoljenja in vezavo storitve.

Odpravljanje težav

Za preverjanje splošnega delovanja middleware ali za obravnavanje napak je lahko koristno uporabiti orodje za ukazno vrstico »Android Debug Bridge (ADB)«, npr. v sistemu Windows.

Za to mora biti ADB za Windows na voljo v imeniku na vašem računalniku.

• Androidno napravo priključite na računalnik z operacijskim sistemom Windows prek USB-ja,
• odprite ukazno vrstico v imeniku ADB,
• in vnesite naslednji ukaz:

adb logcat "RetailForceService:D *:S"

Ta ukaz prikaže vse vpise v dnevniku, kot bi jih običajno našli v dnevniških datotekah storitve Windows ali Docker.

Ta članek je bil samodejno preveden.