Wysyłanie opinii o aplikacji do usług EMM

Dostawcy usług zarządzania urządzeniami mobilnymi (EMM) oferują rozwiązania dla organizacji aby zarządzać urządzeniami z Androidem i zainstalowanymi na nich aplikacjami. Te rozwiązania są zwykle są dostępne pod postacią konsol sieciowych nazywanych konsolami EMM. Korzystanie z usług EMM konsoli, administratorzy IT wykonują zadania związane z zarządzaniem urządzeniami i aplikacjami w imieniu swoich użytkowników Twojej organizacji.

Aplikacje kierowane do organizacji mogą przesyłać do dostawców usług EMM opinie w postaci: z kluczowymi stanami aplikacji. Dla usług EMM dostępne są interfejsy API do pobierania danych o stanie aplikacji z kluczami, które mogą następnie wyświetlić w konsoli EMM. Ten kanał komunikacji umożliwia administratorom IT otrzymywanie opinii o stanie zainstalowanych aplikacji zarządzanych urządzeniach.

Na przykład klient poczty e-mail może używać stanów aplikacji z kluczami, aby potwierdzić, że udało się skonfigurować konto. W razie wystąpienia błędów synchronizacji zgłoś lub wyślij inne aktualizacje stanu, które deweloper aplikacji uzna za odpowiednie.

Komponenty stanu aplikacji z kluczem

Stan aplikacji z kluczem składa się z tych elementów:

• Klucz: unikalny identyfikator stanu aplikacji. Maksymalnie 100 znaków.
• Wiadomość:opcjonalny komunikat opisujący stan aplikacji. Maksymalnie 1000 znaków. Uwaga: zwykle wiadomości powinny być znacznie krótsze.
• Dane: opcjonalna wartość, czytelna dla komputera, przeznaczona dla dostawców usług EMM, która umożliwia administratorom IT aby skonfigurować alerty lub filtry na podstawie tej wartości. Administrator IT może na przykład skonfigurować alert, jeśli pole danych battery_percentage < 10. Maksymalnie 1000 znaków.
• Waga : waga stanu aplikacji. Dozwolone wartości to SEVERITY_ERROR i SEVERITY_INFO (domyślna). Ustaw wagę tylko na SEVERITY_ERROR pod kątem rzeczywistych błędów, które organizacja musi podjąć, aby rozwiązać problem.
• Sygnatura czasowa: gdy stan aplikacji z kluczem jest ustawiony, jest on automatycznie wysyłany z następującym tagiem sygnatura czasowa w milisekundach od początku epoki.

Prześlij opinię o konfiguracjach zarządzanych

Jeśli aplikacja obsługuje konfiguracje zarządzane, wysyłanie stanów aplikacji z kluczami jest zalecanym sposobem aktualizowania stan ustawionych konfiguracji. Poniższy przykładowy przepływ pracy opisuje aby to osiągnąć.

1. Administratorzy IT w konsoli EMM mogą konfigurować i wysyłać konfiguracje zarządzane aplikacja zainstalowana na w pełni zarządzanym urządzeniu; lub w profilu służbowym. Na przykład:
   • Głośność: „50%”
   • Waluta: „USDD”
2. Aplikacja próbuje zastosować konfiguracje. Głośność została ustawiona do 50%, ale kod waluty jest nieprawidłowy i nie można go zastosować.
3. Na podstawie stanu każdej konfiguracji aplikacja ustawia stan aplikacji z kluczem. Każdy stan aplikacji z kluczem zawiera unikalny klucz i komunikat ze szczegółami stanu. Zalecamy dopasowanie klucza konfiguracji zarządzanych tam, gdzie jest to możliwe. Na przykład:

   Klucz	przekaz,	Poziom	Sygnatura czasowa
   volume	Ustaw 50%	SEVERITY_INFO	1554461130
   currency	Waluta „USDD” nie rozpoznano	SEVERITY_ERROR	1554461130

4. Dostawca usług EMM pobiera stany aplikacji z kluczami ustawione przez aplikację i wyświetla w konsoli EMM. Na przykład:

   Konfiguracja	Stan	Wymagane działanie	Godzina
   Głośność	Ustaw 50%	Nie	5 kwietnia 2019 r.; 10:45:30
   Waluta	BŁĄD: waluta „USDD” Nie rozpoznano.	Tak	5 kwietnia 2019 r.; 10:45:30

   Dostawca usług EMM powinien też wyraźnie oznaczać otrzymane stany za pomocą parametru SEVERITY_ERROR z administratorem IT. Administratorzy IT mogą wyświetlać te informacje w konsoli EMM. którzy naprawiają błędy w ustawionych przez nich konfiguracjach.

Zgłoś naprawione błędy

Po usunięciu błędu natychmiast wyślij do uniemożliwia dostawcom usług EMM wyświetlanie komunikatu o błędzie bez końca. Ta odpowiedź stan powinien zawierać:

• Ten sam klucz jako początkowy komunikat o błędzie.
• ma wagę SEVERITY_INFO, , który wskazuje, że stan nie występuje w stanie błędu i nie wymaga od organizacji podjęcia dalszych działań.

Dodaj do aplikacji obsługę stanów aplikacji z kluczem

Poniżej znajdziesz instrukcje integrowania z aplikacją stanów aplikacji z kluczami.

Krok 1. Dodaj repozytorium Maven Google do pliku settings.gradle

Dodaj repozytorium Maven Google jako lokalizację repozytorium w folderze settings.gradle projektu zgodnie z poniższym przykładem:

dependencyResolutionManagement {
  repositoriesMode.set(RepositoriesMode.FAIL_ON_PROJECT_REPOS)
  repositories {
       google()
  }
}

Krok 2. Dodaj bibliotekę opinii firmowych do pliku build.gradle na poziomie modułu

Dodaj następującą zależność do build.gradle na poziomie modułu: plik:

dependencies {
    implementation 'androidx.enterprise:enterprise-feedback:1.0.0'
}

Krok 3. Pobierz instancję KeyedAppStatesReporter

W metodzie onCreate() pobierz i zapisz instancję KeyedAppStatesReporter Umożliwia to komunikację między Twoją aplikacją a dostawcami usług EMM.

Kotlin

val reporter = KeyedAppStatesReporter.create(context)

Java

KeyedAppStatesReporter reporter = KeyedAppStatesReporter.create(context);

Krok 4. Utwórz zbiór stanów aplikacji z kluczami

Podczas tworzenia stanów aplikacji z kluczowymi elementami postępuj zgodnie ze sprawdzonymi metodami opisanymi poniżej:

• Nigdy nie podawaj w stanie informacji umożliwiających identyfikację osoby – stany aplikacji z kluczem nie są jest odpowiedni dla danych wrażliwych.
• Trzymaj stany aplikacji jako kluczowe w limitach określonych w MAX_KEY_LENGTH MAX_MESSAGE_LENGTH, i MAX_DATA_LENGTH.
• Jedno wywołanie setStates lub setStatesImmediate może mieć łącznie maksymalnie 300 KB (około 1/3 wszystkich danych, które można zapisać dziennie). Przekroczenie tego limitu spowoduje zachowanie nieoczekiwanego zachowania.
• Ustaw tylko wagę stanu na SEVERITY_ERROR .
• Gdy wysyłasz stan aplikacji zawierający błędy, pamiętaj, by wysłać także po usunięciu błędów i w takiej sytuacji dostawca usług EMM może w konsoli administracyjnej.
• W przypadku stanu działań użyj tej samej wartości key jako stan początkowy, który zwrócił błąd i ustawił wagę na SEVERITY_INFO.

Fragment kodu poniżej tworzy zbiór stanów aplikacji z kluczami:

Kotlin

    val states = hashSetOf(KeyedAppState.builder()
             .setKey("key")
             .setSeverity(KeyedAppState.SEVERITY_INFO)
             .setMessage("message")
             .setData("data")
             .build())
    

Java

    Collection states = new HashSet<>();
    states.add(KeyedAppState.builder()
     .setKey("key")
     .setSeverity(KeyedAppState.SEVERITY_INFO)
     .setMessage("message")
     .setData("data")
     .build());
    

Krok 5. Ustaw stany aplikacji z kluczem

Uwaga: dla swojej aplikacji możesz skonfigurować maksymalnie 500 unikalnych kluczy dziennie. Nie ma do liczby stanów, które można ustawić dla każdego unikalnego klucza.

setStates() natychmiast wysyła do aplikacji Sklep Play stany aplikacji z kluczem (nazwa pakietu: com.android.vending), jeśli jest ona zainstalowana na urządzeniu, oraz u wszystkich administratorów na urządzeniu lub w profilu służbowym.

Kotlin

keyedAppStatesReporter.setStates(states)

Java

keyedAppStatesReporter.setStates(states);

Testowanie stanów aplikacji z kluczem

Szczegółowe instrukcje testowania znajdziesz w artykule Testowanie opinii o aplikacji.