Από την έκδοση 1.11.2 και μετά, η Υπηρεσία Φορολογικής Καταγραφής RetailForce («middleware») θα είναι επίσης διαθέσιμη ως εγγενής υπηρεσία για Android.

Μπορείτε να βρείτε την υπηρεσία για Android στην ενότητα «Λήψεις» του RetailForce website για την αντίστοιχη έκδοση (retailforce.TrustedFiscalModule-Signed.apk).

Εγκατάσταση

Για να εγκαταστήσετε την υπηρεσία Android, κατεβάστε την στη σχετική συσκευή. Για να εγκαταστήσετε την υπηρεσία, πρέπει να ορίσετε την άδεια εγκατάστασης («Εμπιστευθείτε αυτήν την πηγή»).

Μετά την εγκατάσταση, η υπηρεσία εκτελείται αυτόματα.

Μπορείτε επίσης να διανείμετε το αρχείο APK μέσω ενός συστήματος MDM (Mobile Device Management).

Ενσωμάτωση

Η υπηρεσία RetailForce Fiscalisation για Android λειτουργεί ως υπηρεσία πρώτου πλάνου.

Για να συνδεθείτε στην υπηρεσία RetailForce για Android, η εφαρμογή πρέπει να εκτελέσει τα ακόλουθα βήματα:

• Δικαιώματα στο AndroidManifest.xml

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

• Κλήση της υπηρεσίας RetailForce για Android (παράδειγμα για C#, αλλά παρόμοιο σε 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);
}
```

• Σύνδεση με την υπηρεσία RetailForce για 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");
}
```

• Ζητήστε άδεια.

Ενδέχεται να χρειαστεί να ζητηθεί άδεια για την κλήση μιας υπηρεσίας Foreground (από την έκδοση 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 για Android εκτελείται στη διεύθυνση http://127.0.0.1:7678/api/v1/ και είναι προσβάσιμη μέσω REST (όπως και η υπηρεσία REST RetailForce Fiscalisation στα Windows, στο Docker ή στην υπηρεσία Cloud Fiscalisation).

Διαφορετικές εκδόσεις Android

Προς το παρόν, η υπηρεσία RetailForce για Android έχει δοκιμαστεί μόνο στα Android 14 και 15.

Για παλαιότερες εκδόσεις Android, ενδέχεται να χρειαστεί μια μικρή προσαρμογή του κώδικα, ειδικά όσον αφορά τα δικαιώματα και τη σύνδεση της υπηρεσίας.

Αντιμετώπιση προβλημάτων

Για να ελέγξετε τη γενική λειτουργία του middleware ή για τη διαχείριση σφαλμάτων, μπορεί να είναι χρήσιμο να χρησιμοποιήσετε το εργαλείο γραμμής εντολών «Android Debug Bridge (ADB)», π.χ. στα Windows.

Για να γίνει αυτό, το ADB για Windows πρέπει να είναι διαθέσιμο σε έναν κατάλογο στον υπολογιστή σας.

• Συνδέστε τη συσκευή Android στον υπολογιστή με Windows μέσω USB,
• ανοίξτε μια γραμμή εντολών στον κατάλογο του ADB,
• και πληκτρολογήστε την ακόλουθη εντολή:

adb logcat "RetailForceService:D *:S"

Αυτή η εντολή εμφανίζει όλες τις καταχωρήσεις καταγραφής, όπως θα τις βρίσκατε κανονικά στα αρχεία καταγραφής των υπηρεσιών των Windows ή του Docker.

Αυτό το άρθρο μεταφράστηκε αυτόματα.