Az 1.11.2-es release-től kezdve a RetailForce Fiscalisation Service („middleware”) natív szolgáltatásként is elérhető lesz Androidra.

Az Android-szolgáltatást a RetailForce website letöltések részében találja meg az adott verzióhoz (retailforce.TrustedFiscalModule-Signed.apk).

Telepítés

Az Android-szolgáltatás telepítéséhez töltse le azt a megfelelő eszközre. A szolgáltatás telepítéséhez be kell állítania a telepítési engedélyt („Bízzon ebben a forrásban”).

A telepítés után a szolgáltatás automatikusan elindul.

Az APK-fájlt MDM (Mobile Device Management) rendszeren keresztül is terjesztheti.

Integráció

A RetailForce Fiscalisation Service for Android előtérszolgáltatásként fut.

Az Androidra készült RetailForce-szolgáltatáshoz való csatlakozáshoz az alkalmazásnak a következő lépéseket kell végrehajtania:

• Engedélyek az AndroidManifest.xml fájlban

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

• Hívja meg a RetailForce szolgáltatást Androidra (példa C#-ban, de hasonló Java / Kotlin esetén is)

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

• Kapcsolódás az Android-ra készült RetailForce szolgáltatáshoz

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

• Engedély kérése.

Előfordulhat, hogy engedélyt kell kérni az előtérbeli szolgáltatás meghívásához (Android 13-tól kezdődően).

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

Az Android-ra készült RetailForce szolgáltatás a http://127.0.0.1:7678/api/v1/ címen fut, és REST-en keresztül érhető el (akárcsak a Windows-on, a Dockerben vagy a Cloud Fiscalisation Service-ben futó RetailForce Fiscalisation REST-szolgáltatás).

Különböző Android-verziók

Jelenleg az Androidra szánt RetailForce szolgáltatást csak az Android 14 és 15 verziókon tesztelték.

Régebbi Android-verziók esetén szükség lehet a kód enyhe módosítására, különösen a jogosultságok és a szolgáltatás-összekapcsolás tekintetében.

Hibaelhárítás

A middleware általános működésének ellenőrzéséhez vagy a hibakezeléshez hasznos lehet az „Android Debug Bridge (ADB)” parancssori eszköz használata, pl. Windows rendszeren.

Ehhez az ADB for Windows programnak elérhetőnek kell lennie a számítógép egyik könyvtárában.

• Csatlakoztassa az Android-eszközt USB-n keresztül a Windows-PC-hez,
• nyisson meg egy parancssort az ADB könyvtárban,
• és írja be a következő parancsot:

adb logcat "RetailForceService:D *:S"

Ez a parancs megjeleníti az összes naplóbejegyzést, ahogyan azok általában a Windows vagy a Docker szolgáltatás naplófájljaiban megtalálhatók.

Ezt a cikket automatikusan lefordították.