image-package

Disk üzerindeki Azure Sphere görüntülerini yönetir.

Işlem	Açıklama
pack-application	Bir görüntü paketi oluşturur.
pack-board-config	Pano yapılandırma görüntü paketi oluşturur.
Göster	Görüntü paketiyle ilgili ayrıntıları görüntüler.

pack-application

Derlenmiş ve bağlı bir görüntüden ve app_manifest.json dosyasından yürütülebilir bir uygulama oluşturur.

Gerçek zamanlı uyumlu uygulamalar (RTApps), ham ikili dosyalar olarak değil, ELF veya AXF dosyaları olarak oluşturulur. RTApp paketlemeden önce uygulama bildirim dosyasını ApplicationType'ın "RealTimeCapable" olarak, EntryPoint'in ise uygulama dizininin kökünde olması gereken ELF veya AXF dosyasının adına ayarlanacak şekilde düzenleyin.

Ipucu

Bu komut, Visual Studio Code veya Visual Studio kullanarak üst düzey bir uygulama veya gerçek zamanlı özellikli bir uygulama oluşturduğunuzda çalıştırılır.

• Derleme işlemi, parametresinde --package-directory belirtilen giriş dizini olan bir approot<uygulama adı> dizini oluşturur.
• Uygulama bildirim dosyası parametresinde --application-manifest sağlanır.
• Üst düzey uygulamalar için parametresinde --target-api-set bir uygulama çalışma zamanı sürümü sağlanır.

Gerekli parametreler

Parametre	Türü	Açıklama
--Hedef	Görüntü paketinin yolu	Çıkış görüntüsü paketi için bir yol ve dosya adı belirtir.
--package-directory	approot_folder yolu	Azure Sphere görüntü dosyası için sistem kökü olarak kullanılan giriş dizinini tanımlar. Uygulamanın app_manifest.json dosyası bu dizinde olmalıdır.

İsteğe bağlı parametreler

Parametre	Türü	Açıklama
-a, --application-manifest	Dize	Uygulama bildirim dosyasının yolunu belirtir. Bu bir JSON dosyası veya app_manifest.json içeren bir dizin olabilir. Göreli veya mutlak bir yol sağlayabilirsiniz.
--hardware-definitions	Dize	Donanım tanımı (JSON) dosyalarını içeren dizinlere giden yolların isteğe bağlı bir boşlukla ayrılmış listesini belirtir. Dosyalardaki değerler, app_manifest.json'daki çevre birimi adlarını temel alınan değerlerle eşlemek için kullanılır. Göreli veya mutlak bir yol sağlayabilirsiniz. Daha fazla bilgi için donanım tanımına bakın.
--target-api-set	Dize	Derleme sırasında kullanılan hedef API kümesinin adını belirtir. Uygulama bildiriminde belirtilmezse üst düzey uygulamalar için gereklidir. RTApps için gerekli değildir.
--target-definition-filename	Dize	app_manifest.json dosyasında çevre birimi adlarını eşlemek için kullanılan donanım hedef tanım dosyasının adını belirtir. Uygulama donanım tanımları kullanıyorsa sağlanmalıdır.
-x, --yürütülebilir dosyalar	yürütülebilir1,yürütülebilir2 ...	Görüntü paketinde yürütülebilir olarak işaretlemek için bir veya daha fazla dosyanın yollarını belirtir. app_manifest dosyalarında listelenen EntryPoint her zaman yürütülebilir olarak işaretlenir, bu nedenle -x bayrağı yalnızca diğer yürütülebilir dosyalar varsa gereklidir. Varsayılan olarak, dosyalar bir görüntüye paketlendiğinde yürütülebilir değildir. Alt yollar yürütülebilir dosyalar yoluna göredir. Yollar Windows dosya adı söz dizimi (ters eğik çizgi) veya Linux dosya adı söz dizimi (eğik çizgi) kullanabilir; boşluklara, virgüllere ve noktalı virgüllere izin verilmez. Her yürütülebilir dosya için -x belirtebilir veya yalnızca bir kez kullanabilir ve aralıksız virgülle ayrılmış birden çok yol sağlayabilirsiniz.

Genel parametreler

Azure Sphere CLI için aşağıdaki genel parametreler kullanılabilir:

Parametre	Açıklama
--Hata ayıklama	Tüm hata ayıklama günlüklerini göstermek için günlük ayrıntı düzeyini artırır. Bir hata bulursanız, hata raporu gönderirken bayrağıyla --debug oluşturulan çıkışı sağlayın.
-h, --help	Komutlar ve bağımsız değişkenleri hakkındaki CLI başvuru bilgilerini yazdırır ve kullanılabilir alt grupları ve komutları listeler.
--only-show-errors	Yalnızca hataları gösterir ve uyarıları gizler.
-o, --output	Çıkış biçimini değiştirir. Kullanılabilir çıkış biçimleri json, jsonc (renklendirilmiş JSON), tsv (Sekmeyle Ayrılmış Değerler), tablo (insan tarafından okunabilir ASCII tabloları) ve yaml'dir. CLI varsayılan olarak çıkışlarıdır table. Kullanılabilir çıkış biçimleri hakkında daha fazla bilgi edinmek için bkz. Azure Sphere CLI komutları için çıkış biçimi.
--Sorgu	Azure Sphere Güvenlik Hizmetleri'nden döndürülen çıkışı filtrelemek için JMESPath sorgu dilini kullanır. Daha fazla bilgi ve örnek için bkz. JMESPath öğreticisi ve Azure CLI komut çıktısını sorgulama .
--Ayrıntılı	Bir işlem sırasında Azure Sphere'da oluşturulan kaynaklar hakkındaki bilgileri ve diğer yararlı bilgileri yazdırır. Tam hata ayıklama günlükleri için kullanın --debug .

Not

Azure Sphere klasik CLI kullanıyorsanız, kullanılabilir seçenekler hakkında daha fazla bilgi için bkz. Genel parametreler .

Örnek

azsphere image-package pack-application --package-directory C:\AppSamples\LocalSamples\HelloWorld\HelloWorld_HighLevelApp\out\ARM-Debug\approotHelloWorld_HighLevelApp --destination myimage.imagepackage

pack-board-config

Pano yapılandırma görüntü paketi oluşturur. Önceden ayarlanmış bir pano yapılandırma görüntüsü kullanabilir veya özel bir yapılandırma görüntüsü sağlayabilirsiniz.

Gerekli parametreler

Parametre	Türü	Açıklama
--Hedef	Dize	Sonuçta elde edilen görüntü paketi için çıkış dosya adının yolunu belirtir.

İsteğe bağlı parametreler

Parametre	Türü	Açıklama
--board-config-file	Yolu	Pano yapılandırma görüntüsünün yolunu tanımlar. Bu dahil edilirse, --preset kullanılmamalıdır; iki parametre birbirini dışlar.
-n, --name	Dize	Oluşturulan dosyanın meta verilerinde görüntü paketi adını ayarlar. Sağlanmazsa, sağlanan pano yapılandırmasına göre yeni bir ad oluşturulur ve benzersizlik için bileşen kimliğinin bir parçası eklenir.
-p, --preset	Dize	Uygulanacak önceden ayarlanmış pano yapılandırma görüntüsünün kimliğini sağlar. Önceden ayarlanmış bir paketin kimliğini girin veya özel pano yapılandırma görüntüsü parametresini --board-config-file kullanarak pano yapılandırma dosyası için bir yol sağlayın. Kimlik bir numaralandırma değeridir ve şu anda tek değere lan-enc28j60-isu0-int5sabittir.

Genel parametreler

Azure Sphere CLI için aşağıdaki genel parametreler kullanılabilir:

Parametre	Açıklama
--Hata ayıklama	Tüm hata ayıklama günlüklerini göstermek için günlük ayrıntı düzeyini artırır. Bir hata bulursanız, hata raporu gönderirken bayrağıyla --debug oluşturulan çıkışı sağlayın.
-h, --help	Komutlar ve bağımsız değişkenleri hakkındaki CLI başvuru bilgilerini yazdırır ve kullanılabilir alt grupları ve komutları listeler.
--only-show-errors	Yalnızca hataları gösterir ve uyarıları gizler.
-o, --output	Çıkış biçimini değiştirir. Kullanılabilir çıkış biçimleri json, jsonc (renklendirilmiş JSON), tsv (Sekmeyle Ayrılmış Değerler), tablo (insan tarafından okunabilir ASCII tabloları) ve yaml'dir. CLI varsayılan olarak çıkışlarıdır table. Kullanılabilir çıkış biçimleri hakkında daha fazla bilgi edinmek için bkz. Azure Sphere CLI komutları için çıkış biçimi.
--Sorgu	Azure Sphere Güvenlik Hizmetleri'nden döndürülen çıkışı filtrelemek için JMESPath sorgu dilini kullanır. Daha fazla bilgi ve örnek için bkz. JMESPath öğreticisi ve Azure CLI komut çıktısını sorgulama .
--Ayrıntılı	Bir işlem sırasında Azure Sphere'da oluşturulan kaynaklar hakkındaki bilgileri ve diğer yararlı bilgileri yazdırır. Tam hata ayıklama günlükleri için kullanın --debug .

Not

Azure Sphere klasik CLI kullanıyorsanız, kullanılabilir seçenekler hakkında daha fazla bilgi için bkz. Genel parametreler .

Örnek

azsphere image-package pack-board-config --preset lan-enc28j60-isu0-int5 --destination board2.imagepackage

Göster

Görüntü paketi hakkındaki bilgileri görüntüler.

Gerekli parametreler

Parametre	Türü	Açıklama
-f, --image-package	Dize	Görüntü paketinin yolunu belirtir. Göreli veya mutlak bir yol sağlayabilirsiniz.

Genel parametreler

Azure Sphere CLI için aşağıdaki genel parametreler kullanılabilir:

Parametre	Açıklama
--Hata ayıklama	Tüm hata ayıklama günlüklerini göstermek için günlük ayrıntı düzeyini artırır. Bir hata bulursanız, hata raporu gönderirken bayrağıyla --debug oluşturulan çıkışı sağlayın.
-h, --help	Komutlar ve bağımsız değişkenleri hakkındaki CLI başvuru bilgilerini yazdırır ve kullanılabilir alt grupları ve komutları listeler.
--only-show-errors	Yalnızca hataları gösterir ve uyarıları gizler.
-o, --output	Çıkış biçimini değiştirir. Kullanılabilir çıkış biçimleri json, jsonc (renklendirilmiş JSON), tsv (Sekmeyle Ayrılmış Değerler), tablo (insan tarafından okunabilir ASCII tabloları) ve yaml'dir. CLI varsayılan olarak çıkışlarıdır table. Kullanılabilir çıkış biçimleri hakkında daha fazla bilgi edinmek için bkz. Azure Sphere CLI komutları için çıkış biçimi.
--Sorgu	Azure Sphere Güvenlik Hizmetleri'nden döndürülen çıkışı filtrelemek için JMESPath sorgu dilini kullanır. Daha fazla bilgi ve örnek için bkz. JMESPath öğreticisi ve Azure CLI komut çıktısını sorgulama .
--Ayrıntılı	Bir işlem sırasında Azure Sphere'da oluşturulan kaynaklar hakkındaki bilgileri ve diğer yararlı bilgileri yazdırır. Tam hata ayıklama günlükleri için kullanın --debug .

Not

Azure Sphere klasik CLI kullanıyorsanız, kullanılabilir seçenekler hakkında daha fazla bilgi için bkz. Genel parametreler .

Örnek

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