Co to jest element aplikacji?

Aplikacje AppStudio są zapisywane na platformie ArcGIS jako elementy. Każda aplikacja, zarówno ta nowa, jak i tworzona na podstawie szablonu, składa się z tych samych plików bazowych oraz zasobów niestandardowych użytkownika. Element aplikacji można udostępniać między własnymi urządzeniami lub innym użytkownikom, ale można też skierować żądanie do usługi Make w chmurze Esri w celu wygenerowania plików instalacyjnych właściwych dla danego systemu operacyjnego. Poniżej znajduje się opis plików zawartych w elemencie aplikacji.

Appinfo

Appinfo jest plikiem konfiguracyjnym zawierającym informacje, które definiują działanie aplikacji. Jeśli aplikacja zawiera właściwości, które zostały zdefiniowane w jej ustawieniach, są one zapisane w pliku Appinfo i mogą obejmować:

  • Możliwości, na przykład użycie sygnału audio, Bluetooth, aparatu, czujników lokalizacji, mikrofonu, sieci i pamięci.
  • Wybór platformy wdrażania.
  • Specyfikację minimalnego rozmiaru wyświetlacza, układu pionowego, czy też poziomego.
  • Właściwości zdefiniowane przez użytkownika.
  • Zasoby, na przykład obrazy tła i ikon aplikacji.
  • Pliki z tłumaczeniami i ich lokalizacja.

Appschema

Appschema jest plikiem konfiguracyjnym, który definiuje sposób prezentacji zdefiniowanych przez użytkownika właściwości aplikacji w ustawieniach aplikacji AppStudio. Na drugiej karcie narzędzia Ustawienia — domyślnie ma ona nazwę Właściwości, ale nazwę tę można dostosować — wyświetlane są wszystkie właściwości zdefiniowane przez użytkownika. W zależności od definicji zawartych w pliku Appschema każdą właściwość można wyświetlić w interfejsie użytkownika, co pomaga użytkownikowi w zmianie właściwości, lub w postaci prostej listy właściwości do edycji.

Jeśli na przykład zdefiniowana właściwość ma typ „image”, w przeglądarce obrazów jest wyświetlany podgląd obrazu.

Do typów właściwości należą:

  • Note — tekst do wyświetlenia na ekranie. Przydaje się do opisu grupy właściwości.
  • String — zawiera następujące atrybuty: placeholder (tekst zastępczy), regex (sprawdzenie poprawności wzorca wyrażenia regularnego) i error (komunikat o błędzie wyświetlany w przypadku niepoprawnej wartości).
  • Number — zawiera następujące atrybuty: placeholder (tekst zastępczy), minimum (minimalna dozwolona wartość), maximum (maksymalna dozwolona wartość), precision (maksymalna liczba cyfr po separatorze dziesiętnym) i error (komunikat o błędzie wyświetlany w przypadku niepoprawnej wartości).
  • Boolean — wyświetla użytkownikowi element sterujący wartości logicznej (boolean).
  • Richtext — zawiera atrybut placeholder (tekst zastępczy).
  • Options — tablica obiektów zawierających atrybuty label i value.
  • Color — wyświetla użytkownikowi okno wyboru kolorów.
  • File — zawiera następujące atrybuty: folder (nazwa folderu) i filters (tablica ciągów znakowych zawierających filtry plików).
  • Image — zawiera następujące atrybuty: folder (nazwa folderu) i filters (tablica ciągów znakowych zawierających filtry plików).

Dla każdej właściwości można zdefiniować następujące elementy:

  • Type — jeden z opisanych powyżej typów.
  • Name — nazwa właściwości. Nie może zawierać spacji.
  • Label — etykieta właściwości. Może zawierać spacje.
  • Hint — tekst wskazówki ułatwiającej użytkownikowi zdefiniowanie właściwości.
  • Value — wartość domyślna właściwości.

Właściwości można dzielić na kategorie, dzięki czemu można je wyświetlać użytkownikowi w grupach. Kategorie można na przykład wyświetlać w postaci kart. Można dostosować tytuł karty właściwości i kart kategorii.

Iteminfo

Iteminfo jest plikiem konfiguracyjnym zawierającym informacje, które definiują element platformy ArcGIS, w tym:

  • Informacje o dostępie i uprawnieniach.
  • Miniaturę, nazwę elementu, podsumowanie i opis.
  • Informacje o właścicielu, instytucji i grupie.
  • Znaczniki i słowa kluczowe.

QML/JavaScript

Pliki .qml i .js znajdujące się w strukturze aplikacji. Jeśli do utworzenia aplikacji użyto polecanego szablonu, widocznych jest wiele plików .qml. W przypadku utworzenia nowej aplikacji w AppStudio widoczny jest jeden plik .qml, chociaż aplikacja może używać dowolnej liczby plików .qml. Kod JavaScript może być zapisany w plikach .qml (jak to pokazano w przypadku polecanych aplikacji) lub kod QML może się do odwoływać do kodu JavaScript zapisanego w zewnętrznych plikach .js.

Zasoby

Do zasobów należą obrazy tła, przycisków i logotyp, a także inne dane, które mają się znaleźć w aplikacji. Aby zasoby te zostały uwzględnione w elemencie platformy ArcGIS, muszą znajdować się w folderze projektu i kolejnych dystrybucjach lub plikach instalacyjnych.