image-package
디스크에서 Azure Sphere 이미지를 관리합니다.
| 작업 | 설명 |
|---|---|
| pack-application | 이미지 패키지를 만듭니다. |
| pack-board-config | 보드 구성 이미지 패키지를 만듭니다. |
| 표시 | 이미지 패키지에 대한 세부 정보를 표시합니다. |
pack-application
컴파일되고 연결된 이미지 및 app_manifest.json 파일에서 실행 파일 애플리케이션을 만듭니다.
RTApps(실시간 지원 애플리케이션)는 원시 이진 파일이 아닌 ELF 또는 AXF 파일로 빌드됩니다. RTApp을 패키징하기 전에 ApplicationType 이 "RealTimeCapable"로 설정되고 EntryPoint 가 애플리케이션 디렉터리의 루트에 있어야 하는 ELF 또는 AXF 파일의 이름으로 설정되도록 애플리케이션 매니페스트 파일을 편집합니다.
팁
이 명령은 Visual Studio Code 또는 Visual Studio를 사용하여 상위 수준 애플리케이션 또는 실시간 지원 애플리케이션을 빌드할 때 실행됩니다.
- 빌드 프로세스는 매개 변수에 지정된
--package-directory입력 디렉터리인 approot<앱 이름> 디렉터리를 만듭니다. - 애플리케이션 매니페스트 파일은 매개 변수에
--application-manifest제공됩니다. - 상위 수준 애플리케이션의 경우 애플리케이션 런타임 버전이 매개 변수에
--target-api-set제공됩니다.
필수 매개 변수
| 매개 변수 | 형식 | 설명 |
|---|---|---|
| --대상 | 이미지 패키지 경로 | 출력 이미지 패키지의 경로 및 파일 이름을 지정합니다. |
| --package-directory | approot_folder 경로 | Azure Sphere 이미지 파일의 시스템 루트로 사용되는 입력 디렉터리를 식별합니다. 애플리케이션에 대한 app_manifest.json 파일은 이 디렉터리에 있어야 합니다. |
선택적 매개 변수
| 매개 변수 | 형식 | 설명 |
|---|---|---|
| -a, --application-manifest | 문자열 | 애플리케이션 매니페스트 파일의 경로를 지정합니다. JSON 파일 또는 app_manifest.json이 포함된 디렉터리일 수 있습니다. 상대 경로 또는 절대 경로를 제공할 수 있습니다. |
| --hardware-definitions | 문자열 | JSON(하드웨어 정의) 파일이 포함된 디렉터리에 대한 선택적 공간 구분 경로 목록을 지정합니다. 파일의 값은 app_manifest.json의 주변 이름을 기본 값에 매핑하는 데 사용됩니다. 상대 경로 또는 절대 경로를 제공할 수 있습니다. 자세한 내용은 하드웨어 정의를 참조하세요. |
| --target-api-set | 문자열 | 컴파일 중에 사용되는 대상 API 집합의 이름을 지정합니다. 앱 매니페스트에 지정되지 않은 경우 상위 수준 앱에 필요합니다. RTApps에는 필요하지 않습니다. |
| --target-definition-filename | 문자열 | app_manifest.json에서 주변 장치 이름을 매핑하는 데 사용되는 하드웨어 대상 정의 파일의 이름을 지정합니다. 애플리케이션에서 하드웨어 정의를 사용하는 경우 제공해야 합니다. |
| -x, --executables | executable1,executable2 ... | 이미지 패키지에서 실행 파일로 표시할 하나 이상의 파일에 대한 경로를 지정합니다. app_manifest 파일에 나열된 EntryPoint 는 항상 실행 파일로 표시되므로 다른 실행 파일이 있는 경우에만 -x 플래그가 필요합니다. 기본적으로 파일은 이미지에 패키지된 경우 실행 가능하지 않습니다. 하위 경로는 실행 파일의 경로를 기준으로 합니다. 경로는 Windows 파일 이름 구문(backslashes) 또는 Linux 파일 이름 구문(슬래시)을 사용할 수 있습니다. 공백, 쉼표 및 세미콜론은 허용되지 않습니다. 각 실행 파일에 대해 -x를 지정하거나 한 번만 사용하고 공백을 개입하지 않고 쉼표로 구분된 여러 경로를 제공할 수 있습니다. |
전역 매개 변수
Azure Sphere CLI에 사용할 수 있는 전역 매개 변수는 다음과 같습니다.
| 매개 변수 | 설명 |
|---|---|
| --디버그 | 모든 디버그 로그를 표시하도록 로깅 세부 정보를 늘립니다. 버그가 발견되면 버그 보고서를 제출할 때 플래그가 --debug 켜진 상태에서 생성된 출력을 제공합니다. |
| -h, --help | 명령 및 해당 인수에 대한 CLI 참조 정보를 인쇄하고 사용 가능한 하위 그룹 및 명령을 나열합니다. |
| --only-show-errors | 오류만 표시하고 경고를 표시하지 않습니다. |
| -o, --output | 출력 형식을 변경합니다. 사용 가능한 출력 형식은 json, jsonc(색이 지정된 JSON), tsv(탭으로 구분된 값), 테이블(사람이 읽을 수 있는 ASCII 테이블) 및 yaml입니다. 기본적으로 CLI는 를 출력합니다 table. 사용 가능한 출력 형식에 대한 자세한 내용은 Azure Sphere CLI 명령에 대한 출력 형식을 참조하세요. |
| --쿼리 | JMESPath 쿼리 언어를 사용하여 Azure Sphere Security Services에서 반환된 출력을 필터링합니다. 자세한 내용 및 예제 는 JMESPath 자습서 및 Azure CLI 명령 출력 쿼리 를 참조하세요. |
| --자세한 | 작업 중에 Azure Sphere에서 만든 리소스에 대한 정보 및 기타 유용한 정보를 출력합니다. 전체 디버그 로그에 사용합니다 --debug . |
참고
Azure Sphere 클래식 CLI를 사용하는 경우 사용 가능한 옵션에 대한 자세한 내용은 전역 매개 변수 를 참조하세요.
예제
azsphere image-package pack-application --package-directory C:\AppSamples\LocalSamples\HelloWorld\HelloWorld_HighLevelApp\out\ARM-Debug\approotHelloWorld_HighLevelApp --destination myimage.imagepackage
pack-board-config
보드 구성 이미지 패키지를 만듭니다. 미리 설정된 보드 구성 이미지를 사용하거나 사용자 지정 구성 이미지를 제공할 수 있습니다.
필수 매개 변수
| 매개 변수 | 형식 | 설명 |
|---|---|---|
| --대상 | 문자열 | 결과 이미지 패키지에 대한 출력 파일 이름의 경로를 지정합니다. |
선택적 매개 변수
| 매개 변수 | 형식 | 설명 |
|---|---|---|
| --board-config-file | 경로 | 보드 구성 이미지의 경로를 식별합니다. 이 매개 변수가 포함된 경우 를 --preset 사용하면 안 됩니다. 두 매개 변수는 함께 사용할 수 없습니다. |
| -n, --name | 문자열 | 만든 파일의 메타데이터에서 이미지 패키지 이름을 설정합니다. 제공되지 않으면 제공된 보드 구성에 따라 새 이름이 생성되고 고유성을 위해 구성 요소 ID의 일부가 통합됩니다. |
| -p, --preset | 문자열 | 적용할 미리 설정된 보드 구성 이미지의 ID를 제공합니다. 미리 설정된 패키지의 ID를 입력하거나 사용자 지정 보드 구성 이미지에 대한 매개 변수를 사용하여 보드 구성 파일의 --board-config-file 경로를 제공합니다. ID는 열거형 값이며 현재 단일 값 lan-enc28j60-isu0-int5으로 고정되어 있습니다. |
전역 매개 변수
Azure Sphere CLI에 사용할 수 있는 전역 매개 변수는 다음과 같습니다.
| 매개 변수 | 설명 |
|---|---|
| --디버그 | 모든 디버그 로그를 표시하도록 로깅 세부 정보를 늘립니다. 버그가 발견되면 버그 보고서를 제출할 때 플래그가 --debug 켜진 상태에서 생성된 출력을 제공합니다. |
| -h, --help | 명령 및 해당 인수에 대한 CLI 참조 정보를 인쇄하고 사용 가능한 하위 그룹 및 명령을 나열합니다. |
| --only-show-errors | 오류만 표시하고 경고를 표시하지 않습니다. |
| -o, --output | 출력 형식을 변경합니다. 사용 가능한 출력 형식은 json, jsonc(색이 지정된 JSON), tsv(탭으로 구분된 값), 테이블(사람이 읽을 수 있는 ASCII 테이블) 및 yaml입니다. 기본적으로 CLI는 를 출력합니다 table. 사용 가능한 출력 형식에 대한 자세한 내용은 Azure Sphere CLI 명령에 대한 출력 형식을 참조하세요. |
| --쿼리 | JMESPath 쿼리 언어를 사용하여 Azure Sphere Security Services에서 반환된 출력을 필터링합니다. 자세한 내용 및 예제 는 JMESPath 자습서 및 Azure CLI 명령 출력 쿼리 를 참조하세요. |
| --자세한 | 작업 중에 Azure Sphere에서 만든 리소스에 대한 정보 및 기타 유용한 정보를 출력합니다. 전체 디버그 로그에 사용합니다 --debug . |
참고
Azure Sphere 클래식 CLI를 사용하는 경우 사용 가능한 옵션에 대한 자세한 내용은 전역 매개 변수 를 참조하세요.
예제
azsphere image-package pack-board-config --preset lan-enc28j60-isu0-int5 --destination board2.imagepackage
표시
이미지 패키지에 대한 정보를 표시합니다.
필수 매개 변수
| 매개 변수 | 형식 | 설명 |
|---|---|---|
| -f, --image-package | 문자열 | 이미지 패키지의 경로를 지정합니다. 상대 경로 또는 절대 경로를 제공할 수 있습니다. |
전역 매개 변수
Azure Sphere CLI에 사용할 수 있는 전역 매개 변수는 다음과 같습니다.
| 매개 변수 | 설명 |
|---|---|
| --디버그 | 모든 디버그 로그를 표시하도록 로깅 세부 정보를 늘립니다. 버그가 발견되면 버그 보고서를 제출할 때 플래그가 --debug 켜진 상태에서 생성된 출력을 제공합니다. |
| -h, --help | 명령 및 해당 인수에 대한 CLI 참조 정보를 인쇄하고 사용 가능한 하위 그룹 및 명령을 나열합니다. |
| --only-show-errors | 오류만 표시하고 경고를 표시하지 않습니다. |
| -o, --output | 출력 형식을 변경합니다. 사용 가능한 출력 형식은 json, jsonc(색이 지정된 JSON), tsv(탭으로 구분된 값), 테이블(사람이 읽을 수 있는 ASCII 테이블) 및 yaml입니다. 기본적으로 CLI는 를 출력합니다 table. 사용 가능한 출력 형식에 대한 자세한 내용은 Azure Sphere CLI 명령에 대한 출력 형식을 참조하세요. |
| --쿼리 | JMESPath 쿼리 언어를 사용하여 Azure Sphere Security Services에서 반환된 출력을 필터링합니다. 자세한 내용 및 예제 는 JMESPath 자습서 및 Azure CLI 명령 출력 쿼리 를 참조하세요. |
| --자세한 | 작업 중에 Azure Sphere에서 만든 리소스에 대한 정보 및 기타 유용한 정보를 출력합니다. 전체 디버그 로그에 사용합니다 --debug . |
참고
Azure Sphere 클래식 CLI를 사용하는 경우 사용 가능한 옵션에 대한 자세한 내용은 전역 매개 변수 를 참조하세요.
예제
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