AMAGE Shell

Instalacja

Aplikację instalujemy z oficjalnego sklepu internetowego platformy Android tj. Google Play Store lub ze sklepu internetowego firmy Huawei tj. Huawei AppGallery.

Wyszukujemy AMAGE Shell i możemy już instalować aplikację.

amage shell 58b94
Rysunek 1. Widok aplikacji w Google Play Store
amage shell 8fd5d
Rysunek 2. Widok aplikacji w Huawei AppGallery

Po zainstalowaniu tworzy się wpis w menu głównym oraz (w zależności od wersji systemu operacyjnego) również pojawia się ikona aplikacji na ekranie głównym.

amage shell pulpit pl
Rysunek 3. Pulpit z ikoną startową

Po uruchomieniu aplikacji pojawia się ekran startowy i system wczytuje niezbędne biblioteki i środowisko uruchomieniowe.

amage shell splash pl
Rysunek 4. Splash

Aplikacja umożliwia wyjście po podwójnym wybraniu przycisku wstecz. Jest to przydatne w przypadku, gdy nawigacja jest realizowana poprzez przyciski wstecz ale również w przypadku nowszych wersji systemu Android poprzez gesty.

Konfiguracja początkowa

W przypadku pierwszego uruchomienia aplikacji, użytkownikowi przedstawiany jest kreator konfiguracji początkowej. Poszczególne kroki informują o zadaniach aplikacji oraz pozwalają skonfigurować niezbędne komponenty.

Wszystkie ustawienia wprowadzane na etapie kreatora można zmienić później w ustawieniach aplikacji.
amage shell wizard 1 pl
Rysunek 5. Kreator początkowy - wstęp

Następny krok pokazuje informację dotyczącą uprawnień niezbędnych dla działania aplikacji oraz ich zastosowanie. Za pomocą przycisku Przyznaj uprawnienia należy nadać wszystkie wymagane uprawnienia dla aplikacji. Ułatwia to pracę z wszystkimi funkcjonalnościami.

index dd8a1
Rysunek 6. Kreator początkowy - informacja o uprawnieniach

W kolejnym użytkownik decyduje, który interfejs do odczytu kodów jest przez niego wybrany. W zależności od tego czy uruchamiamy aplikację na zwykłym telefonie/tablecie czy na urządzeniu zaawansowanym wyposażonym w przemysłowe czytniki kodów należy wybrać odpowiedni interfejs.

  • Dla telefonów, tabletów z dostępnym tylko aparatem fotograficznym, wybieramy aparat

  • Dla urządzeń przemysłowych z wbudowanymi specjalnymi czytnikami kodów, wybieramy drugą opcję.

amage shell wizard 2 pl
Rysunek 7. Kreator początkowy - typ skanera

W trzecim kroku system prosi o zeskanowanie kodu dostępnego w oknie logowania instancji aplikacji AMAGE Web, do której użytkownik chce się zalogować i wykorzystywać do pracy. Kod jest dostępny w oknie logowania (kod QR). Po zeskanowaniu, dane serwera zapisywane są w konfiguracji aplikacji i ten interfejs będzie domyślnie ładowany.

index 91664
Rysunek 8. Kreator początkowy - zeskanowanie

Krok 4, to krok kończący konfigurację.

amage shell wizard 4 pl
Rysunek 9. Kreator początkowy - zakończenie

Po zakończeniu kreatora, aplikacja ładuje domyślny interfejs, który będzie od teraz dostępny zawsze po uruchomieniu aplikacji (pominięty kreator początkowy).

Interfejs aplikacji

W przypadku, gdy nie wprowadziliśmy/zeskanowaliśmy danych konfiguracyjnych instancji, system będzie pokazywał okno z możliwością wywołania skanera i sparowania z systemem AMAGE/AMAGE24.

index 3ada3
Rysunek 10. Okno z aktywnym parowaniem

Interfejs aplikacji domyślnie uruchamiany jest w interfejsie standardowym. Główny obszar zajmuje system AMAGE Web ładowany z wybranego podczas konfiguracji serwera. Dodatkowo w górnej belce dostępne jest menu, z dostępem do ustawień.

amage shell interfejs non fullscreen
Rysunek 11. Interfejs normalny

W przypadku konfiguracji w panelu bocznym (patrz niżej) ustawienia pełnego ekranu, interfejs główny jest zmaksymalizowany i wykorzystuje całą dostępną powierzchnię ekranu.

amage shell interfejs non fullscreen
Rysunek 12. Interfejs zmaksymalizowany
Ustawienia poszczególnych komponentów i funkcji dostępne są w panelu bocznym.

Samouczek

Podczas pierwszego uruchomienia aplikacji włączony zostaje samouczek. Samouczek pokazuje poszczególne komponenty interfejsu i wyjaśnia ich zastosowanie. Samouczek pokazuje komponenty zarówno w głównym oknie jak i w menu bocznym z wszystkimi dodatkowymi opcjami.

amage shell 7a956

Po przejściu całego cyklu samouczka jak i po jego anulowaniu system nie pokazuje go ponownie chyba, że zostanie włączona akcja Resetuj samouczek z menu głównego aplikacji.

Menu główne aplikacji pozwala na dostęp do:

  • Ustawienia - dostęp do ustawień aplikacji

  • Kreator początkowy - uruchomienie ponowne kreatora początkowego

  • Wyczyść ciasteczka - czyszczenie ciasteczek (cookies) przeglądarki internetowej. Może pomóc w niektórych przypadkach, gdy aplikacja pamięta np. logowanie użytkownika.

  • Resetuj samouczek - uruchamia ponownie samouczek przy starcie aplikacji (dla głównego okna i panela bocznego)

  • Pokaż listę beacon’ów (BT) - wyświetla okno z informacją dotyczącą aktywnych i widocznych beaconów Bluetooth w zasięgu

  • Utwórz skrót na głównym ekranie - utworzenie skrótu do aktualnej instancji aplikacji na głównym ekranie Androida (skrót)

  • O programie - okno informacji o programie

index ca1b3
Rysunek 13. Menu główne

Panel boczny

W zależności od wybranego interfejsu (normalny, pełny ekran) panel boczny dostępny jest w menu typu hamburger i/lub poprzez przesunięcie palca od lewej krawędzi ekranu ku środkowi.

W panelu bocznym dostępne są opcje konfiguracji oraz dodatkowe przyciski akcji.

index 6d2b8
Rysunek 14. Akcje kontekstowe
  • Włącz/wyłącz przycisk akcji

  • Włącz/wyłącz obsługę czytnika RFID

  • Włącz/wyłącz skaner bluetooth - dla beaconów Bluetooth

  • Włącz/wyłącz pełny ekran

  • Pasek skalowania pozwalający dostosować rozmiar czcionek w głównym widoku do rozdzielczości ekranu danego urządzenia

Oraz przyciski: * przejście do strony startowej * przejście do ustawień aplikacji * odświeżenie widoku * przyciski wywołania aplikacji aparatu fotograficznego oraz skanera kodów kreskowych

Po włączeniu przycisków pojawia się w dolnej części ekranu głównego przycisk "+", który pozwala na wyświetlenie wszystkich przycisków i wykonanie tych akcji.
amage shell kontekstowe akcje pl 1
Rysunek 15. Akcje kontekstowe

Po wybraniu przycisku rozwija się on do dostępnych akcji (zdjęcie, skan kodu).

amage shell 5d626
Rysunek 16. Akcje kontekstowe - rozwinięte
Funkcja aparatu fotograficznego pozwala na wywołanie domyślnej aplikacji do wykonywania zdjęć. Zdjęcia po wykonaniu zapisywane są w pamięci urządzenia i NIE są domyślnie wysyłane na serwer. Wykonywane jest to przez dedykowaną akcję w interfejsie głównym aplikacji. Pozwala to na wykonanie wielu zdjęć przez aparat a następnie wczytanie ich wszystkich w jednym kroku do systemu

Ustawienia aplikacji

Po przejściu do ustawień aplikacji albo przez menu w górnej części aplikacji w widoku standardowych lub przez akcję w panelu bocznym, system prezentuje dostępne główne ustawienia. Ustawienia te były wprowadzone w trakcie pokazywania kreatora początkowego, ale zawsze można je zmienić w dalszym etapie używania aplikacji.

index 31d3b
Rysunek 17. Ustawienia główne

Dostępne ustawienia to adres aplikacji AMAGE Web (odczytany z kodu QR z okna logowania) oraz typ skanera kodów. Wszystkie te ustawienia można zmienić w tej sekcji ustawień.

W ustawieniach serwera mamy możliwość ręcznego wprowadzenia adresu instancji (jeśli nie wykorzystamy kreatorów/skanowania/parowania). W przypadku, gdy korzystamy z urządzeń, które pracują w sieciach korporacyjnych i wykorzystują autoryzację Azure AD/Microsoft Intune dla urządzeń, to możemy wybrać Używaj certyfikatów klienta w celu autoryzacji wieloetapowej podczas logowania do instancji AMAGE.

index c4609
Rysunek 18. Ustawienia adresu serwera

Typ czytnika możemy wybrać z opcji. Dla większości użytkowników potrzebujemy wybrać opcję Zintegrowana kamera. Dla urządzeń specjalistycznych z czytnikami przemysłowymi wbudowanymi w urządzenie (lub podłączonym przez bluetooth) możemy skorzystać z Dedykowanego skanera.

amage shell ustawienia czytnik pl
Rysunek 19. Ustawienia typu czytnika

Dane zostają zapisane i będą wykorzystywane każdorazowo przez aplikację w kolejnych uruchomieniach.

Adres aplikacji w przypadku utworzenia skrótu na pulpicie Android’a będzie zmieniany w zależności od adresu, który był aktywny w trakcie tworzenia skrótu.

Przeglądarka tagów bluetooth

Aplikacja posiada wbudowaną przeglądarkę dostępnych tagów/Beaconów bluetooth obsługiwanych przez system. Za pomocą przeglądarki możemy podglądnąć widoczne w zasięgu znaczniki, ich stan baterii, temperaturę i datę ostatniej widoczności.

index 5d03e
Rysunek 20. Przeglądarka beacon’ów

W przypadku, gdy nie ma włączonej przeglądarki Bluetooth (w szufladzie w głównych opcjach), to zostanie domyślnie wyświetlona informacja o braku włączonego skanowania Bluetooth oraz przycisk umożliwiający włączenie tego skanowania.

image 2023 11 09 11 37 00 436
Rysunek 21. Brak włączonej przeglądarki bluetooth

Jeśli beacon, który wcześniej został odczytany zniknie z zasięgu, to jego opis tekstowy zmienia kolor na ciemnoszary. Jeśli zasięg wróci, to kolor jego adresu zmieni się na domyślny.

index 1a576
Rysunek 22. Widok beacon’a, który zniknął z zasięgu

Rejestracja na serwerze notyfikacji

Aplikacja po poprawnej autoryzacji użytkownika w docelowym systemie (tylko wtedy!) przesyła dodatkową informację do centralnego serwera powiadomień. W informacji przesyłane są dane identyfikujące użytkownika (jego UUID oraz instancja, do której się zalogował). Jeśli użytkownik włączy przesyłanie powiadomień na urządzenie mobilnej w konfiguracji notyfikacji aplikacji AMAGE, to powiadomienia będą przesyłane na to urządzenie.

Inne akcje

W menu głównym obok przejścia do głównych ustawień aplikacji dostępna jest opcja usuń ciasteczka. W przypadku pracy aplikacji z serwerem WWW aplikacja zapisuje wszystkie ciasteczka (ang. cookies) przesyłane przez aplikację WWW lokalnie. Przy zamknięciu aplikacji dane te zapisywane są w pamięci nieulotnej i przywracane w momencie ponownego startu aplikacji. Pozwala to na zapamiętanie ciasteczek pomiędzy uruchomieniami aplikacji np. zapamiętanie informacji o zalogowaniu użytkownika.

Skrót do aplikacji

Aplikacja może utworzyć skrót do aplikacji na pulpicie systemu Android, który będzie odpowiadał aktualnie wybranemu adresowi serwera AMAGE Web. Pozwala to na posiadanie skrótów do różnych systemów AMAGE na jednym urządzeniu mobilnym.

Aby utworzyć skrót należy wywołać z menu głównego akcję tworzenia skrótu. Po potwierdzeniu tworzenia skrótu można zmienić jego tytuł.

amage shell skrot 1
Rysunek 23. Skrót — krok 1
amage shell skrot 2
Rysunek 24. Skrót — krok 2

Zatwierdzenie skrótu tworzy nową ikoną na pulpicie systemu Android z dodatkowym emblematem systemu AMAGE.

amage shell skrot 3
Rysunek 25. Skrót — krok 3

Okno informacji o aplikacji

Okno informacji o aplikacji zawiera informacje podstawowe, numer wersji oraz adresy i łącza do kanałów sieci społecznościowych, email oraz strony internetowej producenta.

amage shell okno about pl
Rysunek 26. Okno informacji

Hasła logowania

Zapamiętywanie haseł logowania jest uzależnione od wersji systemu Android oraz funkcjonalności udostępnianych przez dane urządzenie. Większość takich urządzeń powinna udostępniać automatyczne zapamiętywanie haseł wykorzystując system natywny urządzenia. Hasła w takim przypadku są chronione zabezpieczeniami systemu operacyjnego co zwiększa bezpieczeństwo ich przechowywania.

amage shell fc697
Rysunek 27. Interfejs logowania - wybór pary login/hasło do uzupełnienia
amage shell 7f28e
Rysunek 28. Zabezpieczenie dodatkowe (autoryzacja odciskiem palca)
amage shell a47ef
Rysunek 29. Uzupełniony login oraz hasło
System w zależności od konfiguracji wdrożenia posiada włączone zapamiętywanie stanu zalogowania przez 5 dni (konfigurowalne). Po poprawnym zalogowaniu w aplikacji system pamięta i automatyczne loguje użytkownika do momentu aż nie minie czas lub zostaną wyczyszczone dane konfiguracyjne aplikacji.

Dziennik zmian

Podczas aktualizacji aplikacji przez sklep Google Play Store, instalujemy nową wersję aplikacji. Po ponownym jej uruchomieniu, użytkownikowi prezentowany jest dziennik zmian wprowadzonych we wszystkich wersjach aplikacji. Najnowsze zmiany prezentowane są na początku listy.

amage shell changelog
Rysunek 30. Dziennik zmian