Skip to main content

Přehled

Aplikace Deb jsou nativní balíčky, které běží přímo v hostitelském systému TOS 7. Řídí se standardními specifikacemi balení Debianu, přizpůsobenými pro správu služeb TOS a integraci s platformou.

Aplikace Deb pro TOS 7 se dělí na tři podtypy podle toho, zda mají frontendovou stránku a jak se otevírá:

PodtypPřípad použitíZpůsob otevřeníKomunikace s backendem
Interní otevření WebUIBackend je místní spustitelná služba, frontend je statické WebUIVložený iframe v desktopu TOSUnix Socket + platformový proxy
Externí otevření WebUIBackend je místní spustitelná služba, frontend je statické WebUINová karta prohlížečereverzní proxy Nginx + HTTP port
Služba bez UISlužba na pozadí bez rozhraníBez frontendové stránkyPodle potřeby (bez povinných požadavků)

Povinná omezení výběru podtypu:

Charakteristika aplikacePožadovaný podtyp
Má webové UI a musí se otevírat v rámci desktopu TOSInterní otevření WebUI (iframe)
Má webové UI a musí se otevírat v kartě prohlížečeExterní otevření WebUI (nová karta)
Bez frontendu / služba na pozadíSlužba bez UI
Potřebuje přístup k souborovému systému zařízení prostřednictvím Správce souborů TOSInterní nebo externí otevření WebUI — pokud aplikace vyžaduje, aby uživatelé vybírali cesty k souborům ve Správci souborů TOS, musí poskytnout WebUI (interní nebo externí) pro vložení komponenty výběru souborů.

Aplikace Deb pro TOS 7 podporují dva způsoby balení:

Způsob baleníPřípad použitíPopis
Metoda 1: Režim jednoho balíčkuNové aplikace vyvíjené od začátkuVývojáři vyvíjejí přímo podle specifikací TOS 7.0 a integrují všechny soubory do jediného balíčku deb
Metoda 2: Režim dvojitého balíčku (nazývaný také režim archivu)Aplikace s existujícími obecnými standardními balíčky debPůvodní balíček aplikace (zdrojový balíček deb) zůstává beze změny, přičemž je dodáván další datový balíček (<appid>.deb) odpovídající specifikacím TOS 7.0; oba jsou zabaleny do archivu tar.gz pro podání

Pravidla použitelnosti režimu dvojitého balíčku:

ScénářMusí použítNesmí použít
Existující obecný standardní balíček deb, složité sestaveníRežim dvojitého balíčku
Nová aplikace vyvíjená od začátkuNedoporučuje se používat režim dvojitého balíčku — pokud neexistuje zvláštní důvod (např. potřeba oddělit konfiguraci od binárních souborů), měly by nové aplikace vyvíjené od začátku používat režim jednoho balíčku.
Jednoduchý binární program, bez existujícího baleníRežim dvojitého balíčku (měl by použít režim jednoho balíčku)
Deb balíčky třetích stran z upstreamuRežim dvojitého balíčku

Povinná omezení režimu dvojitého balíčku:

  • Konzistence verzí: Pole Version datového balíčku a zdrojového balíčku musí být přesně stejná; neshody mají za následek okamžité zamítnutí.
  • Omezení obsahu: Datový balíček (<appid>.deb) nesmí obsahovat žádné binární soubory, jinak bude okamžitě zamítnut.
  • Pořadí instalace: Automaticky zajišťuje mechanismus závislostí úložiště APT (datový balíček Depends na zdrojovém balíčku); není nutná žádná další konfigurace.
  • Nezávislost zdrojového balíčku: Zdrojový balíček deb musí být samostatně instalovatelný na systému TOS 7.0 pomocí příkazu dpkg -i.
  • Deklarace závislostí: Pole Depends v metadatech datového balíčku deb musí obsahovat zdrojový balíček deb, nejlépe také s uvedením verze, aby byly zachovány zdravé vztahy závislostí.