képcsomag
Fontos
Ez az Azure Sphere (örökölt) dokumentációja. Az Azure Sphere (örökölt) 2027. szeptember 27-én nyugdíjba vonul, és a felhasználóknak ekkorra az Azure Sphere-be (integrált) kell migrálniuk. Az Azure Sphere (integrált) dokumentációjának megtekintéséhez használja a TOC felett található Verzióválasztót.
A lemezen lévő Azure Sphere-rendszerképek kezelése.
| Művelet | Leírás |
|---|---|
| csomagalkalmazás | Létrehoz egy képcsomagot. |
| pack-board-config | Létrehoz egy táblakonfigurációs rendszerképcsomagot. |
| mutat | Képcsomag részleteinek megjelenítése. |
csomagalkalmazás
Létrehoz egy végrehajtható alkalmazást egy lefordított és csatolt rendszerképből és egy app_manifest.json fájlból.
A valós idejű kompatibilis alkalmazások (RTApps) ELF- vagy AXF-fájlokként vannak létrehozva, és nem nyers bináris fájlokként. Az RTApp csomagolása előtt szerkessze az alkalmazásjegyzékfájlt úgy, hogy az ApplicationType értéke "RealTimeCapable", az EntryPoint pedig az ELF vagy az AXF fájl neve legyen, amelynek az alkalmazáskönyvtár gyökerében kell lennie.
Tipp.
Ez a parancs akkor fut, ha magas szintű alkalmazást vagy valós idejű képes alkalmazást hoz létre a Visual Studio Code vagy a Visual Studio használatával.
- A létrehozási folyamat létrehoz egy approot alkalmazásnév> könyvtárat<, amely a paraméterben
--package-directorymegadott bemeneti könyvtár. - Az alkalmazásjegyzékfájlt a
--application-manifestparaméter tartalmazza. - A magas szintű alkalmazások esetében az alkalmazás futtatókörnyezetének verziója szerepel a
--target-api-setparaméterben.
Kötelező paraméterek
| Paraméter | Típus | Leírás |
|---|---|---|
| --célállomás | A képcsomag elérési útja | Megadja a kimeneti képcsomag elérési útját és fájlnevét. |
| --package-directory | A approot_folder elérési útja | Azonosítja a bemeneti könyvtárat, amelyet az Azure Sphere rendszerképfájljának rendszergyökereként használnak. Az alkalmazás app_manifest.json fájljának ebben a könyvtárban kell lennie. |
Választható paraméterek
| Paraméter | Típus | Leírás |
|---|---|---|
| -a, --application-manifest | Sztring | Megadja az alkalmazásjegyzékfájl elérési útját. Ez lehet egy JSON-fájl vagy egy app_manifest.json tartalmazó könyvtár. Megadhat egy relatív vagy abszolút elérési utat. |
| --hardverdefiníciók | Sztring | A hardverdefiníciós (JSON-) fájlokat tartalmazó könyvtárak elérési útjainak választható szóközzel elválasztott listáját adja meg. A fájlok értékei a periférianevek app_manifest.json mögöttes értékekre való leképezésére szolgálnak. Megadhat egy relatív vagy abszolút elérési utat. További információt a hardverdefinícióban talál. |
| --target-api-set | Sztring | A fordítás során használt cél API-csoport nevét adja meg. A magas szintű alkalmazásokhoz szükséges, ha nincs megadva az alkalmazásjegyzékben. Az RTAppshez nem szükséges. |
| --target-definition-filename | Sztring | Megadja annak a hardveres céldefiníciós fájlnak a nevét, amelyet a periférianevek leképezéséhez használnak app_manifest.json. Ezt akkor kell megadni, ha az alkalmazás hardverdefiníciókat használ. |
| -x, --végrehajtható fájlok | végrehajtható1,végrehajtható2 ... | Megadja a képcsomagban végrehajthatóként megjelölendő egy vagy több fájl elérési útját. A app_manifest fájlokban felsorolt EntryPoint mindig végrehajthatóként van megjelölve, ezért az -x jelző csak akkor szükséges, ha más végrehajtható elemek is találhatók. Alapértelmezés szerint a fájlok nem futtathatók, ha képbe vannak csomagolva. Az alelérési utak a végrehajtható fájlok elérési útjára vannak viszonyítva. Az elérési utak a Windows fájlnév szintaxisát (fordított perjelek) vagy Linux-fájlnév szintaxist (perjelek) használhatják; szóközök, vesszők és pontosvesszők nem engedélyezettek. Megadhatja az -x értéket minden végrehajtható fájlhoz, vagy csak egyszer használhatja, és több, vesszővel elválasztott elérési utat is megadhat szóközök nélkül. |
Globális paraméterek
Az Azure Sphere CLI-hez a következő globális paraméterek érhetők el:
| Paraméter | Leírás |
|---|---|
| --Debug | Növeli a naplózás részletességét az összes hibakeresési napló megjelenítéséhez. Ha hibát talál, akkor a --debug jelölővel létrehozott kimenetet küldje el a hibajelentéssel együtt. |
| -h, --help | A parancssori felület hivatkozási információit nyomtatja ki a parancsokról és azok argumentumairól, valamint felsorolja az elérhető alcsoportokat és parancsokat. |
| --only-show-errors | Csak a hibákat jeleníti meg, és letiltja a figyelmeztetéseket. |
| -o, --output | Módosítja a kimeneti formátumot. A rendelkezésre álló kimeneti formátumok a json, jsonc (színezett JSON), tsv (Tab-Separated Values), table (human-readable ASCII tables) és yaml. Alapértelmezés szerint a CLI a következő kimenetet használja: table. Az elérhető kimeneti formátumokról további információt az Azure Sphere CLI-parancsok kimeneti formátuma című témakörben talál. |
| --lekérdezés | A JMESPath lekérdezési nyelv használatával szűri az Azure Sphere Security Services által visszaadott kimenetet. További információkért és példákért tekintse meg a JMESPath-oktatóanyagot és az Azure CLI-parancskimenet lekérdezését. |
| --bőbeszédű | Kinyomtatja az Azure Sphere-ben egy művelet során létrehozott erőforrásokra vonatkozó információkat és egyéb hasznos információkat. A --debug használata a teljes hibakeresési naplók megjelenítéséhez. |
Feljegyzés
Ha klasszikus Azure Sphere cli-t használ, a rendelkezésre álló lehetőségekről további információt a globális paraméterekben talál.
Példa
azsphere image-package pack-application --package-directory C:\AppSamples\LocalSamples\HelloWorld\HelloWorld_HighLevelApp\out\ARM-Debug\approotHelloWorld_HighLevelApp --destination myimage.imagepackage
pack-board-config
Létrehoz egy táblakonfigurációs rendszerképcsomagot. Használhat előre beállított táblakonfigurációs lemezképet, vagy egyéni konfigurációs rendszerképet is megadhat.
Kötelező paraméterek
| Paraméter | Típus | Leírás |
|---|---|---|
| --célállomás | Sztring | Megadja az eredményként kapott képcsomag kimeneti fájlnevének elérési útját. |
Választható paraméterek
| Paraméter | Típus | Leírás |
|---|---|---|
| --board-config-file | Elérési út | Azonosítja a tábla konfigurációs lemezképének elérési útját. Ha ez szerepel benne, --preset nem szabad használni; a két paraméter kölcsönösen kizárja egymást. |
| -n, --name | Sztring | Beállítja a képcsomag nevét a létrehozott fájl metaadataiban. Ha nincs megadva, a megadott táblakonfiguráció alapján létrejön egy új név, amely az egyediség érdekében tartalmazza az összetevő azonosítójának egy részét. |
| -p, --preset | Sztring | Megadja az alkalmazni kívánt előre beállított táblakonfigurációs rendszerkép azonosítóját. Adja meg egy előre beállított csomag azonosítóját, vagy adja meg a táblakonfigurációs fájl elérési útját egy egyéni táblakonfigurációs rendszerkép paraméterével --board-config-file . Az azonosító enumerálási érték, és jelenleg az egyetlen értékre lan-enc28j60-isu0-int5van rögzítve. |
Globális paraméterek
Az Azure Sphere CLI-hez a következő globális paraméterek érhetők el:
| Paraméter | Leírás |
|---|---|
| --Debug | Növeli a naplózás részletességét az összes hibakeresési napló megjelenítéséhez. Ha hibát talál, akkor a --debug jelölővel létrehozott kimenetet küldje el a hibajelentéssel együtt. |
| -h, --help | A parancssori felület hivatkozási információit nyomtatja ki a parancsokról és azok argumentumairól, valamint felsorolja az elérhető alcsoportokat és parancsokat. |
| --only-show-errors | Csak a hibákat jeleníti meg, és letiltja a figyelmeztetéseket. |
| -o, --output | Módosítja a kimeneti formátumot. A rendelkezésre álló kimeneti formátumok a json, jsonc (színezett JSON), tsv (Tab-Separated Values), table (human-readable ASCII tables) és yaml. Alapértelmezés szerint a CLI a következő kimenetet használja: table. Az elérhető kimeneti formátumokról további információt az Azure Sphere CLI-parancsok kimeneti formátuma című témakörben talál. |
| --lekérdezés | A JMESPath lekérdezési nyelv használatával szűri az Azure Sphere Security Services által visszaadott kimenetet. További információkért és példákért tekintse meg a JMESPath-oktatóanyagot és az Azure CLI-parancskimenet lekérdezését. |
| --bőbeszédű | Kinyomtatja az Azure Sphere-ben egy művelet során létrehozott erőforrásokra vonatkozó információkat és egyéb hasznos információkat. A --debug használata a teljes hibakeresési naplók megjelenítéséhez. |
Feljegyzés
Ha klasszikus Azure Sphere cli-t használ, a rendelkezésre álló lehetőségekről további információt a globális paraméterekben talál.
Példa
azsphere image-package pack-board-config --preset lan-enc28j60-isu0-int5 --destination board2.imagepackage
megjelenítés
Képcsomagra vonatkozó információkat jelenít meg.
Kötelező paraméterek
| Paraméter | Típus | Leírás |
|---|---|---|
| -f, --image-package | Sztring | Megadja a képcsomag elérési útját. Megadhat egy relatív vagy abszolút elérési utat. |
Globális paraméterek
Az Azure Sphere CLI-hez a következő globális paraméterek érhetők el:
| Paraméter | Leírás |
|---|---|
| --Debug | Növeli a naplózás részletességét az összes hibakeresési napló megjelenítéséhez. Ha hibát talál, akkor a --debug jelölővel létrehozott kimenetet küldje el a hibajelentéssel együtt. |
| -h, --help | A parancssori felület hivatkozási információit nyomtatja ki a parancsokról és azok argumentumairól, valamint felsorolja az elérhető alcsoportokat és parancsokat. |
| --only-show-errors | Csak a hibákat jeleníti meg, és letiltja a figyelmeztetéseket. |
| -o, --output | Módosítja a kimeneti formátumot. A rendelkezésre álló kimeneti formátumok a json, jsonc (színezett JSON), tsv (Tab-Separated Values), table (human-readable ASCII tables) és yaml. Alapértelmezés szerint a CLI a következő kimenetet használja: table. Az elérhető kimeneti formátumokról további információt az Azure Sphere CLI-parancsok kimeneti formátuma című témakörben talál. |
| --lekérdezés | A JMESPath lekérdezési nyelv használatával szűri az Azure Sphere Security Services által visszaadott kimenetet. További információkért és példákért tekintse meg a JMESPath-oktatóanyagot és az Azure CLI-parancskimenet lekérdezését. |
| --bőbeszédű | Kinyomtatja az Azure Sphere-ben egy művelet során létrehozott erőforrásokra vonatkozó információkat és egyéb hasznos információkat. A --debug használata a teljes hibakeresési naplók megjelenítéséhez. |
Feljegyzés
Ha klasszikus Azure Sphere cli-t használ, a rendelkezésre álló lehetőségekről további információt a globális paraméterekben talál.
Példa
azsphere image-package show --image-package C:\sample\quickstart_steps\QuickStart-AzureSphereBlink1\QuickStart-AzureSphereBlink1\out\ARM-Debug\QuickStart-AzureSphereBlink1.imagepackage
Image package metadata:
Section: Identity
Image Type: Application
Component ID: 99d419ef-296d-43b0-ade1-809efe3a7aba
Image ID: d788fdd1-28eb-4477-9818-a4734289f2f1
Section: Signature
Signing Type: ECDsa256
Cert: a8d5cc6958f48710140d7a26160fc1cfc31f5df0
Section: Debug
Image Name: QuickStart-AzureSphereBlink1
Built On (UTC): 09/07/2020 13:18:52
Built On (Local): 09/07/2020 14:18:52
Section: Temporary Image
Remove image at boot: False
Under development: True
Section: ABI Depends
Depends on: ApplicationRuntime, version 5