Fra release 1.11.2 og fremover vil RetailForce Fiscalisation Service (‘middleware’) også være tilgængelig som en native tjeneste til Android.

Du kan finde Android-tjenesten i download-sektionen på RetailForce website for den pågældende version (retailforce.TrustedFiscalModule-Signed.apk).

Installation

For at installere Android-tjenesten skal du downloade den til den relevante enhed. For at installere tjenesten skal du indstille installationstilladelsen („Stol på denne kilde“).

Efter installationen kører tjenesten automatisk.

Du kan også distribuere APK-filen via et MDM-system (Mobile Device Management).

Integration

RetailForce Fiscalisation Service til Android kører som en forgrundstjeneste.

For at oprette forbindelse til RetailForce-tjenesten til Android skal appen udføre følgende trin:

• Tilladelser i AndroidManifest.xml

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

• Kald RetailForce-tjenesten til Android (eksempel for C#, men tilsvarende i 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);
}
```

• Opret forbindelse til RetailForce-tjenesten til 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");
}
```

• Anmod om tilladelse.

Det kan være nødvendigt at anmode om tilladelse til at kalde en Foreground-tjeneste (fra og med Android 13).

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

RetailForce-tjenesten til Android kører på http://127.0.0.1:7678/api/v1/ og kan tilgås via REST (ligesom RetailForce Fiscalisation REST-tjenesten på Windows, Docker eller Cloud Fiscalisation Service).

Forskellige Android-versioner

I øjeblikket er RetailForce-tjenesten til Android kun blevet testet på Android 14 og 15.

For ældre Android-versioner kan det være nødvendigt at justere koden en smule, især med hensyn til tilladelser og servicebinding.

Fejlfinding

For at kontrollere middlewarens generelle funktion eller til fejlhåndtering kan det være nyttigt at bruge kommandolinjeværktøjet 'Android Debug Bridge (ADB)', f.eks. under Windows.

For at gøre dette skal ADB til Windows være tilgængeligt i et bibliotek på din computer.

• Tilslut Android-enheden til Windows-pc'en via USB,
• åbn en kommandoprompt i ADB-mappen,
• og indtast følgende kommando:

adb logcat "RetailForceService:D *:S"

Denne kommando viser alle logposter, som du normalt ville finde dem i logfilerne for Windows- eller Docker-tjenesten.

Denne artikel er oversat automatisk.