Příručka pro vývojáře pro vytváření metadat služby
Varování o zastarání MBAE
Důležitý
Počínaje Windows 10, verzí 1803, je prostředí aplikace MBAE nahrazeno aplikací MO UWP. Další informace o aplikacích MO UWP naleznete v tématu mobilní širokopásmové aplikace pro UWP.
Tato příručka vás provede procesem vytvoření balíčku metadat služby na hardwarovém řídicím panelu windows Dev Center, dříve označovaném jako Sysdev. K připojení mobilní širokopásmové aplikace k hardwarovému zařízení se vyžadují metadata služby. Když uživatel připojí mobilní širokopásmové zařízení do svého počítače, stáhne se přidružená metadata služby a mobilní širokopásmová aplikace se automaticky stáhne.
Metadata služeb můžete využít k vytvoření hluboce integrovaného prostředí s Windows. Balíčky metadat služeb umožňují zahrnout informace o značce, jako jsou ikony a název operátora, konfigurovat nastavení a oprávnění pro přístup k hardwaru SIM a osobním hotspotům a zřizovat mobilní širokopásmové aplikace pro práci s mobilním širokopásmovým zařízením.
Poznámka
I když je mobilní širokopásmová aplikace nainstalovaná automaticky, uživatel ji musí připnout na úvodní obrazovku ručně.
Začínáme
Pokud chcete vytvořit úspěšný balíček metadat služby, musíte dokončit kroky uvedené v této části.
Registrace společnosti na hardwarovém řídicím panelu Windows Dev Center
Vaše společnost má aktivní účet na hardwarovém řídicím panelu Windows Dev Center. Pokud vaše společnost nemá účet na hardwarovém řídicím panelu Windows Dev Center, můžete si vytvořit nový účet a přidat svůj uživatelský účet do vaší společnosti. Další informace naleznete v části Správa v nápovědě k hardwarovému řídicímu panelu Windows Dev Center.
Vaše společnost má podpisový certifikát kódu VeriSign pro podepsání balíčků.
Registrace přístupu k průvodci metadatem služby a identifikátorů služeb
MNO a MVNOs musí před vytvořením balíčku metadat služby provést následující kroky:
- Požádat o přístup k Průvodci metadaty služby.
- Registrace identifikátorů služeb
Pokud chcete provést výše uvedené kroky, musíte přejít na řídicí panel partnerského centra technické podpory a zadat následující informace:
- Název organizace použitý při registraci na hardwarovém řídicím panelu Windows Dev Center.
- Bez ohledu na to, jestli jste operátorem mobilní sítě nebo operátorem mobilní virtuální sítě.
- Váš web a odůvodnění, proč potřebujete vytvořit balíček metadat služby.
Podle potřeby uveďte následující identifikátory služeb:
- Seznam ID zprostředkovatele GSM
- Seznam názvů zprostředkovatelů GSM
- Seznam identifikátorů SID CDMA
- Seznam názvů zprostředkovatelů CDMA
Měli byste obdržet potvrzovací e-maily do 24 hodin, že vaše žádost byla přijata. Zpracování žádosti ale může trvat až 5 pracovních dnů. Pokud dojde ke konfliktům, pošleme vám e-mail s žádostí o další informace.
Mobilní širokopásmová aplikace
Před vytvořením balíčku metadat služby se ujistěte, že byla vyvinuta a přidružena vaše mobilní širokopásmová aplikace k Microsoft Storu. Tato aplikace by měla poskytovat klíčové zážitky, například návrh plánu, využití dat, nápovědu a podporu, stejně jako zdůraznění služeb s přidanou hodnotou od operátora. Další informace o vytvoření mobilní širokopásmové aplikace najdete na následujících odkazech:
- Přehled rozhraní WINRT API pro mobilní širokopásmové připojení
- Přehled hardwaru mobilního operátora
- mobilních širokopásmových aplikací pro UPW
Poznámka
Mobilní širokopásmová aplikace se nemusí publikovat do Microsoft Storu, dokud se neotestují metadata služby a není připravená k externímu publikování. Doporučujeme, aby byla aplikace publikovaná do Microsoft Storu až poté, co balíček metadat služby projde testováním režimu náhledu.
Vytváření balíčků metadat služby
Vytvoření balíčku metadat služby začíná průvodcem metadat služby, který je k dispozici na hardwarovém řídicím panelu windows Dev Center. Další informace o průvodci metadaty služby najdete v kroku 2: Vytvoření balíčku metadat služby. Průvodce metadaty služby můžete použít k vytvoření nového nebo úpravě existujícího balíčku metadat služby. Při procházení průvodce a vyplňování hodnot průvodce ověří a upozorní vás na případné chyby nebo upozornění. Toto ověření zahrnuje kontrolu chybějících nebo nesprávných polí, vlastnictví identifikátoru služby, existenci mobilní širokopásmové aplikace v Microsoft Storu atd.
Když jste na poslední potvrzovací stránce a jste připravení odeslat, máte možnost odeslat balíček buď v režimu Vývojář, nebo Režim náhledu.
vývojářský režim Používá se během počátečních fází, kdy vaším záměrem je jednoduše vytvářet balíčky metadat služby a používat ho pro účely offline testování. V tomto režimu nebude balíček podepsán a bude muset být ručně stažen a nainstalován do testovacího počítače pro účely ověření. Tento režim si můžete prohlédnout jako rychlý a rychlý způsob, jak vytvořit a ověřit, jestli balíčky metadat služby fungují s vaším zařízením.
režim náhledu Používá se, pokud máte jistotu, že balíček je správně vytvořený a je připravený k odeslání na kompletní testování. V tomto režimu bude balíček podepsán hardwarovým řídicím panelem Windows Dev Center a automaticky se stáhne do testovacích počítačů za předpokladu, že jsou testovací počítače správně zřízené.
Až dokončíte testování verze Preview a ověříte, že váš balíček funguje ve všech scénářích, můžete balíček publikovat do provozu.
Následující diagram popisuje pracovní postup:
Pokud chcete vytvořit nový balíček metadat služby, přečtěte si Postup vytvoření balíčku metadat služby.
Pokud chcete upravit existující balíček metadat služby, přečtěte si Postup úprav balíčku metadat služby.
Postup vytvoření balíčku metadat služby
Pomocí následujícího postupu vytvořte balíček metadat služby na hardwarovém řídicím panelu Windows Dev Center:
- 1 Shromážděte požadované informace pro balíček metadat služby
- 2-Vytvořte balíček metadat služby
- 3– Vložte soubor manifestu obchodu do aplikace pro zařízení Microsoft Store
- 4–otestování balíčku metadat služby
- 5-Publikovat balíček metadat služby
1. Shromáždění požadovaných informací pro balíček metadat služby
Při procházení kroků v Průvodci metadaty služby v kroku 2 tohoto tématu je vyžadováno několik informací uložených v souboru package.appxmanifest z projektu mobilní širokopásmové aplikace, který chcete přidružit k zařízení. Pomocí následujících kroků shromážděte informace, aby byly připravené ke kroku 2 tohoto tématu.
Opatrnost
Před shromážděním hodnot v tomto kroku musí být mobilní širokopásmová aplikace přidružená k Microsoft Storu. Když přidružíte mobilní širokopásmovou aplikaci, aktualizují se hodnoty v souboru manifestu balíčku tak, aby používaly informace z vývojářského účtu Microsoft Storu. Mobilní širokopásmová aplikace se ale nemusí publikovat do Microsoft Storu. Zůstane ve vašem místním vývojovém prostředí, dokud nebudete připraveni publikovat balíček metadat služby.
Shromáždění informací o aplikaci pro zařízení s UWP
Otevřete projekt mobilní širokopásmové aplikace pomocí sady Visual Studio 2013.
V pravém podokně klikněte pravým tlačítkem na soubor Package.appxmanifest a potom klikněte na Zobrazit kód.
Shromážděte z souboru package.appxmanifest následující atributy:
- Z elementu Identity se atribut Name použije pro pole název balíčku v Průvodci metadaty služby.
- Pro atribut Publisher v elementu Identity bude použito pole Publisher v Průvodci metadaty služby.
- Z elemetu Applications se atribut Id z podřízeného prvku Application použije pro pole Id aplikace v Průvodci metadaty služby.
Zavřete soubor package.appxmanifest.
Můžete to také dokončit bez použití sady Visual Studio pomocí následujících kroků:
Shromažďování informací o mobilních širokopásmových aplikacích bez použití sady Visual Studio
Přejděte do souboru package.appxmanifest pro vaši mobilní širokopásmovou aplikaci.
Klikněte pravým tlačítkem myši na soubor a potom klikněte na Otevřít pomocí.
Zrušte zaškrtnutí políčka Použít tuto aplikaci pro všechny soubory .appxmanifest, vyberte možnost Další možnostia potom klikněte na Poznámkový blok.
Shromážděte z souboru package.appxmanifest následující atributy:
- Z elementu Identity se atribut Name použije pro pole název balíčku v Průvodci metadaty služby.
- Z prvku Identity bude atribut Publisher použit pro pole Publisher v Průvodci metadaty služby.
- V elementu Applications se pro pole ID aplikace v Průvodci metadaty služby použije atribut Id z podřízeného elementu Application.
Uložte a zavřete soubor package.appxmanifest.
2. Vytvoření balíčku metadat služby
Metadata služby se vytvářejí pomocí Průvodce metadaty služby na hardwarovém řídicím panelu windows Dev Center.
Vytvoření balíčku metadat služby
Přejděte na sysdev.microsoft.com.
Pod nadpisem Metadata zařízení klikněte na Vytvoření prostředí pro mobilní širokopásmové připojení.
Na stránce Informace o službě vyplňte následující pole a klikněte na tlačítko Další.
Zadejte název vaší sítě, který se má použít v uživatelském rozhraní pro výběr sítě systému Windows – název sítě, který se zobrazí zákazníkům ve Správci připojení systému Windows.
Zadejte číslo služby – Identifikátor GUID, který musí odpovídat poli ID operátora v metadatech nastavení. Identifikátor GUID můžete vytvořit pomocí sady Visual Studio 2013. Další informace o tom, jak vytvořit identifikátor GUID, naleznete v tématu Vytvoření GUID (guidgen.exe).
Nahrajte ikonu, která se má zobrazit v uživatelském rozhraní pro výběr sítě systému Windows – Vyberte Procházeta poté vyberte ikonu, která se zobrazí zákazníkům ve Správci připojení systému Windows.
Zadejte obslužnou rutinu události oznámení systému Windows ve vaší aplikaci (volitelné, pokud není vyžadována kontrola nároků níže) – jedná se o obslužnou rutinu oznámení zaregistrovanou v mobilní širokopásmové aplikaci.
Chcete uživatelům povolit sdílení mobilního širokopásmového připojení (osobní hotspot)? – Možné varianty jsou Vždy povolit, Povolit pouze s kontrolou nároků (vyžaduje obslužnou rutinu událostí oznámení systému Windows)a Nikdy nepovolit. Výchozí možností je vždy povolit.
Chcete vyžadovat oprávnění správce systému k provádění odemknutí KÓDU PIN na SIM? – Pokud chcete vyžadovat oprávnění správce systému k odemknutí SIM karty, klikněte na možnost Ano.
Na stránce Informace o hardwaru vyberte informace, které se mají použít k identifikaci vašeho prostředí. Po zaškrtnutí políčka můžete přidat odpovídající rozsahy sítě. Vygenerované ID by mělo existovat v databázi Windows COSA, takže je identifikován správný odběratel. Další informace o databázi COSA najdete v tématu odeslání databáze COSA.
Pokud jste zprostředkovatel GSM, který používá mezinárodní mobilní odběratel identity (IMSI), zaškrtněte políčko IMSI pod nadpisem GSM. Do pole ID zprostředkovatele zadejte ID poskytovatele služeb GSM. Pod nadpisem rozsahy IMSI/ICCID zadejte rozsah a klikněte na Přidat.
Pokud jste poskytovatelem GSM, který používá identifikátor ICCID (Integrated Circuit Card), zaškrtněte políčko ID SIM ICC pod nadpisem GSM. Pod nadpisem "Zadejte ID poskytovatele a rozsah ID ICC" zadejte rozsah a klikněte na Přidat.
Pokud jste poskytovatel GSM, který používá název domácího poskytovatele, zaškrtněte políčko Název domácího poskytovatele pod nadpisem GSM. V části Pod nadpisem Zadejte název domovského poskytovatele nebo ID poskytovatele (MCC+MNC), zadejte ID a název poskytovatele a klikněte na Přidat.
Pokud jste zprostředkovatel CDMA, který používá identifikátor SID, zaškrtněte políčko SID pod nadpisem CDMA. Do Zadejte identifikátor SID, zadejte identifikátor SID CDMA.
Pokud jste zprostředkovatel CDMA, který používá název zprostředkovatele, zaškrtněte políčko Název zprostředkovatele pod nadpisem CDMA. Do pole Zadejte název zprostředkovatele zadejte název poskytovatele služby CDMA.
Vyberte Další.
Na stránce Informace o aplikaci zadejte informace, které jste shromáždili v kroku 1 tohoto tématu. Pokud chcete přidat další privilegované aplikace, klikněte na Přidata zadejte až 7 dalších. Po zadání všech privilegovaných aplikací klikněte na Další.
Na stránce Potvrdit ověřte správnost informací. Vyberte možnost Vývojářský režim nebo Režim náhledu a potom klikněte na Odeslat.
vývojářský režim – Balíček není podepsaný a musí se stáhnout a nainstalovat ručně do každého počítače. Tuto možnost použijte, pokud chcete balíček uložit pro offline vývoj.
Režim náhledu – Balíček je podepsaný a automaticky se stáhne z Microsoftu do testovacích počítačů s nastavenými odpovídajícími registry. Režim náhledu nekontroluje, jestli je mobilní širokopásmová aplikace publikovaná v Microsoft Storu.
3. Vložte soubor manifestu obchodu do aplikace zařízení Microsoft Store.
Soubor manifestu obchodu musí být součástí aplikace pro zařízení UPW. Pomocí následujícího postupu stáhněte soubor manifestu úložiště z balíčku metadat služby a vložte ho do projektu mobilní širokopásmové aplikace.
Vložte soubor manifestu úložiště
Na hardwarovém řídicím panelu Windows Dev Center klikněte na stránku řízení zkušeností vašeho balíčku metadat služby, otevřete balíček metadat služby a potom kliknutím na StoreManifest.xml stáhněte soubor manifestu úložiště.
Otevřete projekt mobilní širokopásmové aplikace pomocí sady Visual Studio 2013.
Klepněte pravým tlačítkem myši na projekt, klepněte na tlačítko Přidata potom klepněte na tlačítko Existující položka.
Přejděte do souboru manifestu úložiště, který jste stáhli, a klepněte na tlačítko Přidat.
Znovu zkompilujte mobilní širokopásmovou aplikaci a publikujte ji znovu do Microsoft Storu.
4. Testování balíčku metadat služby
Pokud chcete balíček metadat služby otestovat, musíte mít mobilní širokopásmové zařízení a soubory balíčku metadat služby. Pokyny ke konfiguraci testovacího systému a instalace balíčku metadat služby závisí na režimu balíčku.
Testování balíčku metadat služby v režimu vývojáře
Aby scénáře fungovaly správně, musíte balíček stáhnout ručně a nainstalovat ho do správného umístění. Balíček v režimu vývojáře bude potřeba získat přístup ze dvou různých vstupních bodů v závislosti na tom, jestli jste vytvořili nový balíček nebo existující balíček.
Pokud jste vytvořili nový balíček, na hardwarovém řídicím panelu Windows Dev Center klikněte na Spravovat prostředía potom klikněte na Nepřidružené vývojové balíčky (první položka v tabulce Spravovat prostředí). Následující obrázek ukazuje příklad:
Pokud jste upravili existující balíček metadat služby, který už je přidružený k prostředí, vyberte prostředí z tabulky Spravovat prostředí a v tabulce se zobrazí balíček režimu vývojáře. Vyberte Stáhnout balíček Zip MBAE ke stažení.
Po stažení balíčku metadat služby musíte povolit podepisování testů, protože balíček metadat služby není podepsaný. Pokud chcete povolit podepisování testů, spusťte příkaz bcdedit –set testsigning na z příkazového řádku se zvýšenými oprávněními a restartujte počítač.
Po povolení testovacího podepisování zkopírujte soubor *.devicemetadata-ms z balíčku metadat služby do následujícího umístění: %ProgramData%\Microsoft\Windows\DeviceMetadataStore\<kultura>, kde <kultura> je aktuální kód kultury pro váš počítač.
Testování balíčku metadat služby v režimu náhledu
Pokud je balíček metadat služby v režimu náhledu, musíte vytvořit položku registru PreviewKey na testovacím počítači. Další informace o konfiguraci položky registru PreviewKey naleznete v tématu Vytvoření balíčku verze Preview.
Poznámka
K otestování balíčku metadat služby, který je v režimu náhledu, není nutné povolit podepisování testů.
Po vytvoření položky registru PreviewKey připojte mobilní širokopásmové zařízení a ujistěte se, že se zobrazí v seznamu Sítě. Pokud ne, další informace najdete v části Řešení potíží.
Vymazání existujících metadat služby
Při instalaci metadat služby na počítači se hodnoty obsažené v metadatech ukládají na mnoha různých místech, včetně registru, mezipaměti metadat, úložiště metadat, profilů WWAN a vývojového uzlu. To může ztížit opakování více testů se stejnými nebo různými balíčky metadat. Abyste měli jistotu, že jsou metadata služby správně nainstalovaná, měli byste vymazat všechna existující metadata služby. Existující metadata služby můžete vymazat nastavením testovacího počítače ke spuštění PowerShell skriptu, který odstraní všechny stopy. Nejprve musíte nastavit prostředí na testovacím počítači:
Poznámka
Nebude to fungovat na zařízení s Windows RT. Postupujte podle kroků v postupu s názvem "Vymazání metadat služby na zařízení se systémem Windows RT".
Nastavení prostředí pro vymazání metadat služby
Stáhněte psexec.exe (https://go.microsoft.com/fwlink/p/?linkid=330071) a pak ho extrahujte do složky.
Stáhněte a nainstalujte sadu Windows Driver Kit windows 8.1 (https://go.microsoft.com/fwlink/?LinkId=330072).
Přejděte do umístění, kde jsou nainstalovány soubory WDK. Výchozí umístění je C:\Program Files (x86)\Windows Kits\8.1\Tools. Pokud váš testovací počítač používá x86, zkopírujte devcon.exe ze složky x86 do stejné složky jako psexec.exe. Pokud na testovacím počítači běží x64, zkopírujte devcon.exe ze složky x64.
Uložte následující skript jako MetadataRemovalScript.ps1 do stejné složky jako Devcon.exe a PsExec.exe.
Poznámka
V poli Uložit jako typ nezapomeňte před uložením souboru vybrat Všechny soubory (*.*).
# DEVICE SHOULD BE CONNECTED TO MACHINE
Write-Host "Launching devcon to remove MBAE software device nodes devcon.exe remove @SWD\MBAE\*"
$DevconParameters = ' remove @SWD\MBAE\* '
try
{
Start-Process devcon.exe -ArgumentList $DevconParameters
}
catch
{
$Error[0] # Dump details about the last error
Write-Host "Error running devcon.exe " $DevconParameters
exit
}
Write-Host "Removing MB Profiles"
$mbprcmd = "mbn sh pr i=*"
$mddelprcmd = "mbn del pr i=* name="
$cmdout = $mbprcmd | netsh | Out-String
$tokens = $cmdout.Split( [String[]] ("`r`n"), [StringSplitOptions]::RemoveEmptyEntries)
if($tokens.Length -gt 3)
{
for($i=3;$i -lt $tokens.Length-1;$i++)
{
$x = $mddelprcmd + '"' + $tokens[$i].trim() +'"'
Write-Host "Deleting Profile Cmd :" $x
$x | netsh
}
}
Write-Host ""
Write-Host "Disabling ALL Mobile Broadband Adapters"
$MBAdapters = Get-Netadapter -Name "Mobile Broadband*"
foreach($MBAdapter in $MBAdapters)
{
Write-Host "Disabling MB Adapter :"$MBAdapter.Name
Disable-NetAdapter -Name $MBAdapter.Name -Confirm:$false
}
Write-Host "Stopping Device Setup Manager Service"
Stop-Service DsmSvc
Write-Host "Removing MBAE metadata packages in store"
#Find Package Ids
$MBAEPackageRegKeyHive = "HKLM:\SOFTWARE\Microsoft\WwanSvc\MobileBroadbandAccounts\Accounts\"
if(Test-Path $MBAEPackageRegKeyHive)
{
$DevMetadataStorePath = join-path -Path $Env:ProgramData -ChildPath "Microsoft\Windows\DeviceMetadataStore"
$PackageIds = Get-ChildItem $MBAEPackageRegKeyHive | ForEach-Object {Get-ItemProperty $_.pspath} | where-object {$_.MetadataPackageId} | Foreach-Object {$_.MetadataPackageId}
foreach($PackageId in $PackageIds)
{
$PackageStoreFile = $PackageId + ".devicemetadata-ms"
$PackageStorePath = Get-ChildItem $DevMetadataStorePath -Recurse -Filter $PackageStoreFile
if($PackageStorePath -ne $null)
{
Write-Host "Deleting Device Metadata Store @" $PackageStorePath.FullName
Remove-Item -Force $PackageStorePath.FullName
}
}
}
Write-Host "Removing all metadata from cache"
$DevMetadataCachePath = join-path -Path $Env:ProgramData -ChildPath "Microsoft\Windows\DeviceMetadataCache\*"
if(Test-Path $DevMetadataCachePath)
{
Write-Host "Delete All Metadata Packages under "$DevMetadataCachePath
Remove-Item -Recurse -Force $DevMetadataCachePath
}
Write-Host "Cleanup MBAE registry keys"
$MBAERegKeyPath = "HKLM:\SOFTWARE\Microsoft\WwanSvc\MobileBroadbandAccounts\*"
if(Test-Path $MBAERegKeyPath)
{
Write-Host "Found MBAE reg keys - deleting"
Remove-Item -Path $MBAERegKeyPath -Recurse
}
Write-Host "Enabling all MB Adapters, press any key to continue"
$keypress = $host.UI.RawUI.ReadKey("NoEcho,IncludeKeyUp")
$MBAdapters = Get-Netadapter -Name "Mobile Broadband*"
foreach($MBAdapter in $MBAdapters)
{
Write-Host "Enabling MB Adapter :"$MBAdapter.Name
Enable-NetAdapter -Name $MBAdapter.Name -Confirm:$false
}
Write-Host "END of Script"
# DEVICE SHOULD BE CONNECTED TO MACHINE
Write-Host "Launching devcon to remove MBAE software device nodes devcon.exe remove @SWD\MBAE\*"
$DevconParameters = ' remove @SWD\MBAE\* '
try
{
Start-Process devcon.exe -ArgumentList $DevconParameters
}
catch
{
$Error[0] # Dump details about the last error
Write-Host "Error running devcon.exe " $DevconParameters
exit
}
Write-Host "Removing MB Profiles"
$mbprcmd = "mbn sh pr i=*"
$mddelprcmd = "mbn del pr i=* name="
$cmdout = $mbprcmd | netsh | Out-String
$tokens = $cmdout.Split( [String[]] ("`r`n"), [StringSplitOptions]::RemoveEmptyEntries)
if($tokens.Length -gt 3)
{
for($i=3;$i -lt $tokens.Length-1;$i++)
{
$x = $mddelprcmd + '"' + $tokens[$i].trim() +'"'
Write-Host "Deleting Profile Cmd :" $x
$x | netsh
}
}
Write-Host ""
Write-Host "Please remove the MB device from the system and press any key to continue"
$keypress = $host.UI.RawUI.ReadKey("NoEcho,IncludeKeyDown")
Write-Host "Removing MBAE metadata packages in cache and store"
#Find Package Ids
$MBAEPackageRegKeyHive = "HKLM:\SOFTWARE\Microsoft\WwanSvc\MobileBroadbandAccounts\Accounts\"
if(Test-Path $MBAEPackageRegKeyHive)
{
$DevMetadataCachePath = join-path -Path $Env:ProgramData -ChildPath "Microsoft\Windows\DeviceMetadataCache"
$DevMetadataStorePath = join-path -Path $Env:ProgramData -ChildPath "Microsoft\Windows\DeviceMetadataStore"
$PackageIds = Get-ChildItem $MBAEPackageRegKeyHive | ForEach-Object {Get-ItemProperty $_.pspath} | where-object {$_.MetadataPackageId} | Foreach-Object {$_.MetadataPackageId}
foreach($PackageId in $PackageIds)
{
$PackageCacheFolder = Get-ChildItem $DevMetadataCachePath -Recurse -Filter $PackageId
if($PackageCacheFolder -ne $null)
{
Write-Host "Deleting Device Metadata Cache @" $PackageCacheFolder.FullName
Remove-Item -Recurse -Force $PackageCacheFolder.FullName
}
$PackageStoreFile = $PackageId + ".devicemetadata-ms"
$PackageStorePath = Get-ChildItem $DevMetadataStorePath -Recurse -Filter $PackageStoreFile
if($PackageStorePath -ne $null)
{
Write-Host "Deleting Device Metadata Store @" $PackageStorePath.FullName
Remove-Item -Force $PackageStorePath.FullName
}
}
}
Write-Host "Cleanup MBAE registry keys"
$MBAERegKeyPath = "HKLM:\SOFTWARE\Microsoft\WwanSvc\MobileBroadbandAccounts\*"
if(Test-Path $MBAERegKeyPath)
{
Write-Host "Found MBAE reg keys - deleting"
Remove-Item -Path $MBAERegKeyPath -Recurse
}
Write-Host "END"
Po nastavení prostředí spusťte následující kroky pokaždé, když chcete vymazat všechna existující metadata služby:
Vymazání metadat služby
- Ujistěte se, že je mobilní širokopásmové zařízení připojené k testovacímu počítači.
- Z příkazového řádku se zvýšenými oprávněními přejděte do složky, do které jste extrahovali psexec.exe, a spusťte psexec /s /i powershell
- V příkazovém řádku PowerShellu přejděte do složky, do které jste extrahovali psexec.exe.
- Zadejte set-executionpolicy unrestricted a stiskněte klávesu Enter.
- Zadejte Y a zadejte.
- Zadejte .\MetadataRemovalScript.ps1 a stiskněte Enter.
- Po zobrazení výzvy odeberte mobilní širokopásmové zařízení a stiskněte Enter.
- Tyto kroky opakujte pokaždé, když chcete vymazat metadata služby z testovacího počítače.
Vymazání metadat služby na zařízení s Windows RT
Odeberte uzly softwarového zařízení.
- Ve Správci zařízení klepněte na tlačítko Zobrazita potom klepněte na tlačítko Zobrazit skrytá zařízení.
- Rozbalte softwarová zařízení.
- Klikněte pravým tlačítkem na následující prvky zařízení a potom klikněte na Odinstalovat: Windows.Devices.Sms.SmsDevice a Windows.Networking/NetworkOperators.MobileBroadbandAccount
Odeberte všechny profily mobilního širokopásmového připojení ze všech rozhraní.
- Na příkazovém řádku se zvýšenými oprávněními zadejte netsh mbn sho pro i=\*
- Pro každý z profilů zadejte netsh mbn delete profile name = "The profile name here" i=\* a poté stiskněte klávesu Enter.
Zakažte všechny adaptéry mobilního širokopásmového připojení.
- Ve Správci zařízení rozbalte síťové adaptéry.
- Klepněte pravým tlačítkem myši na každé mobilní širokopásmové zařízení a klepněte na tlačítko Zakázat.
Na příkazovém řádku se zvýšenými oprávněními zastavte službu DSM zadáním sc stop dsmsvc a stiskněte Enter.
Odeberte balíčky metadat služby z úložiště metadat zařízení odstraněním jakékoli složky, která obsahuje balíček metadat služby z %ProgramData%\Microsoft\Windows\DeviceMetadataStore. Balíčky metadat služby můžete identifikovat vyhledáním souboru MobileBroadbandInfo.xml.
Odstraňte všechny položky registru WWAN SVC MBAE.
- V Editoru registru odstraňte následující položku registru a všechny podřízené položky: HKEY_LOCAL_MACHINE\Software\Microsoft\WwanSvc\MobileBroadbandAccounts.
- Pokud nemáte přístup k odstranění položky registru, musíte mít oprávnění Úplné řízení.
Povolte všechny adaptéry mobilního širokopásmového připojení.
- Ve Správci zařízení rozbalte síťové adaptéry.
- Klepněte pravým tlačítkem myši na každé mobilní širokopásmové zařízení a klepněte na tlačítko Povolit.
5. Publikování balíčku metadat služby
Jakmile ověříte, že balíček metadat služby funguje správně, posledním krokem je vydání balíčku. Balíček můžete uvolnit výběrem balíčku připojeného ke konkrétnímu prostředí kliknutím na tlačítko Release, jak je znázorněno níže.
Postup úprav balíčku metadat služby
Balíček metadat služby můžete upravit pomocí stránky Spravovat prostředí na hardwarovém řídicím panelu Windows Dev Center.
Řešení problémů
Otevřete seznam sítí a vyhledejte mobilní širokopásmovou síť. Pokud je síť uvedená pomocí názvu a ikony, které jste použili v balíčku metadat služby ServiceInfo.xml souboru, balíček se správně parsuje. Pokud aktualizujete balíček metadat služby se stejným názvem a ikonou nebo pokud se název nebo ikona po přibližně jedné minutě v seznamu nezobrazí, měli byste provést další kroky, jak je popsáno tady:
- Vynucení aktualizace metadat
- Kontrola mezipaměti metadat
- Kontrola registru
- Kontrola protokolů WWAN
Vynucení aktualizace metadat
Některé části metadat a systémů mobilních širokopásmových aplikací spoléhají na přístup k síti, což může selhat a nechat počítač v nekonzistentním stavu. Pokud k tomu dojde, můžete narazit na situaci, kdy nejsou nainstalovaná metadata služby nebo není nainstalovaná mobilní širokopásmová aplikace. Systém se pravidelně snaží napravit situaci, ale pro úsporu energie opakování jsou poměrně méně častá (jen párkrát denně). Místo čekání na další opakování můžete aktualizaci vynutit okamžitě ručně. Postupujte takto:
- Otevřete na ploše ovládací panel.
- Otevřete Zařízení a tiskárny.
- V nabídce Zobrazit klikněte na Aktualizovatnebo stiskněte klávesu F5. Tato akce způsobí, že se metadata znovu analyzují a znovu zaregistrují události na pozadí.
Důležitý
Pokud se balíček metadat služby již úspěšně parsoval, systém bude tuto aktualizaci považovat za aktualizaci metadat. V tomto případě musí mít balíček metadat v názvu souboru jiný identifikátor GUID a aktualizované časové razítko v elementu LastModifiedDate u PackageInfo.xml.
Kontrola mezipaměti metadat
Pokud aktualizace metadat problém nevyřeší, ujistěte se, že je balíček metadat služby platný a že má správné ID hardwaru. Postupujte takto:
Přejděte na %programdata%\Microsoft\Windows\DeviceMetadataCache\dmrccache\kultury, kde kód kultury je kód kultury pro aktuální kulturu testovacího počítače (například en-us nebo es-es).
Vyhledejte složku se stejným názvem jako balíček metadat (bez přípony .devicemetadata-ms). Pokud tento adresář neexistuje, může to znamenat jednu ze čtyř věcí:
- Balíček metadat služby je poškozený.
- Balíček metadat služby nemá správná ID hardwaru.
- Mobilní širokopásmové zařízení není ve stavu, kdy je možné stáhnout metadata nebo jste ho připojili před zkopírováním balíčku metadat služby.
- Při kontrole digitálního podpisu v balíčku metadat došlo k potížím. Příčinou je obvykle to, že v testovacím počítači není povolené podepisování testů.
Pokud jste si jisti, že balíček není poškozený a že jste po zkopírování balíčku metadat služby nejprve připojili mobilní širokopásmové zařízení, zkontrolujte rozsahy IMSI. Je velmi snadné napsat příliš mnoho nebo příliš málo nul nebo devítek. Pokud problém přetrvává i po potvrzení nebo opravě těchto položek, musíte se podívat na registr.
Kontrola registru
Varování
Data registru, která nepatří do vaší aplikace, byste neměli upravovat, pokud to není nezbytně nutné. Pokud v registru dojde k chybě, váš systém nemusí správně fungovat. Za žádných okolností klíč registru MobileBroadbandAccounts neodstraňujte. Systém Windows ji znovu nevytvoří a tuto funkci přerušíte.
Proveďte následující kroky a zkontrolujte registr:
Otevřete Editor registru.
Přejděte na HKLM\SOFTWARE\Microsoft\WwanSvc\MobileBroadbandAccounts.
V tomto klíči registru vyhledejte tři další klíče: Účty, NetworkInterfaceBindingsa Data. Tyto klíče ve výchozím nastavení neexistují; automaticky se vytvoří při prvním vložení, zapnutí nebo připojení mobilního širokopásmového zařízení.
Pokud klíče Accounts nebo NetworkInterfaceBindings neexistují a už jste připojili nebo zapnuli svůj mobilní širokopásmový adaptér, zkontrolujte protokoly WWAN.
Pokud některé nebo všechny tyto klíče existují, rozbalte klíč Účty v zobrazení stromové struktury. Jeden nebo více klíčů registru, které mají názvy podobné identifikátorům GUID, by v něm měly existovat. Položky stromu registru by se měly podobat stromu registru, který je zobrazen níže:
Pokud klíč registru vypadá podobně jako na obrázku výše (názvy hodnot se budou mírně lišit v závislosti na tom, jestli je účet v síti GSM nebo CDMA) a pokud ikonu v seznamu sítí nevidíte, měli byste se podívat na protokoly událostí.
Pokud jsou položky registru podobné následujícímu obrázku, znamená to, že se mobilní širokopásmový adaptér vložil před zkopírování balíčku metadat služby do úložiště metadat zařízení, je balíček metadat služby poškozený nebo ID hardwaru jsou nesprávná. Pokud chcete napravit situaci, kdy jste zařízení zapojili nebo zapnuli před zkopírováním balíčku metadat do úložiště metadat, proveďte kroky ve části "Vynutit aktualizaci metadat." V opačném případě postupujte podle kroků v části Kontrola protokolů WWAN.
Kontrola protokolů WWAN
Pokud neexistují žádné účty nebo NetworkInterfaceBindings klíče registru v části HKLM\SOFTWARE\Microsoft\WwanSvc\MobileBroadbandAccountsnebo pokud jsou položky, které nejsou plně vyplněné, musíte se podívat na protokoly WWAN. Následující kroky obnoví počítač do známého stavu:
Odpojte nebo vypněte mobilní širokopásmové zařízení (pokud je zařízení vložené, zakažte ho ve správci zařízení ).
Odstraňte následující klíče registru:
- HKLM\SOFTWARE\Microsoft\WwanSvc\MobileBroadbandAccounts\Accounts
- HKLM\SOFTWARE\Microsoft\WwanSvc\MobileBroadbandAccounts\NetworkInterfaceBindings
Varování
Za žádných okolností neodstraňujte HKLM\SOFTWARE\Microsoft\WwanSvc\MobileBroadbandAccounts\ klíč registru. Systém Windows ji znovu nevytvoří a tuto funkci přerušíte.
V protokolech existují dva typy záznamů, které jsou důležité: záznamy protokolu služby WWAN pro správu účtů a záznamy úlohy analyzátoru. První typ může pomoct s laděním problémů způsobených problémy se síťovým hardwarem a druhý typ může pomoct s laděním problémů s analýzou metadat.
Položky protokolu služby WWAN pro správu účtů pro síť, která je úspěšně zpracována, jsou podobné následujícímu:
[0]02CC.0CD0::2012-01-04 09:22:26.567 [Microsoft-Windows-WWAN-SVC-EVENTS]Account Management: Account updater started for network interface {7a0a0dce-0a51-471a-8c16-6e767cd0b861.
[0]02CC.0CD0::2012-01-04 09:22:26.567 [Microsoft-Windows-WWAN-SVC-EVENTS]Account Management: Getting home provider ID from hardware device for network interface {7A0A0DCE-0A51-471A-8C16-6E767CD0B861}. Provider ID is "234567".
[0]02CC.0CD0::2012-01-04 09:22:26.567 [Microsoft-Windows-WWAN-SVC-EVENTS]Account Management: Getting home provider name from hardware device for network interface {7A0A0DCE-0A51-471A-8C16-6E767CD0B861}. Provider name is "MS GSM".
[0]02CC.0CD0::2012-01-04 09:22:26.586 [Microsoft-Windows-WWAN-SVC-EVENTS]Account Management: Network identity not recognized, assigning new network account ID.
[0]02CC.0CD0::2012-01-04 09:22:26.597 [Microsoft-Windows-WWAN-SVC-EVENTS]Account Management: Devnode create/update started.
[0]02CC.0CD0::2012-01-04 09:22:26.617 [Microsoft-Windows-WWAN-SVC-EVENTS]Account Management: Devnode create/update finished.
[0]02CC.0CD0::2012-01-04 09:22:26.617 [Microsoft-Windows-WWAN-SVC-EVENTS]Account Management: Data store create/update started.
[0]02CC.0CD0::2012-01-04 09:22:26.707 [Microsoft-Windows-WWAN-SVC-EVENTS]Account Management: Data store create/update finished.
[0]02CC.0CD0::2012-01-04 09:22:26.707 [Microsoft-Windows-WWAN-SVC-EVENTS]Account Management: Account updater finished for network interface {7a0a0dce-0a51-471a-8c16-6e767cd0b861}.
Tyto položky můžete najít vyhledáním v logu pro správy účtů. V tomto případě jsou nejdůležitější položky vytvoření/aktualizace úložiště dat zahájeno a vytvoření/aktualizace úložiště dat dokončeno. Pokud tyto položky existují a neobsahují žádné chybové zprávy, hardware se chová správně. (Úložiště dat, na které se zde odkazuje, obsahuje klíče registru, které jsou podrobně popsány v části "Kontrola registru.")
Naproti tomu na zařízení, na kterém je SIM karta odebraná, položky obvykle vypadají takto:
[0]02CC.03E4::2012-01-04 09:29:50.309 [Microsoft-Windows-WWAN-SVC-EVENTS]Account Management: Account updater started for network interface {7a0a0dce-0a51-471a-8c16-6e767cd0b861}.
[0]02CC.03E4::2012-01-04 09:29:50.309 [Microsoft-Windows-WWAN-SVC-EVENTS]Account Management: Detected removal of SIM from device bound to network interface {7A0A0DCE-0A51-471A-8C16-6E767CD0B861}.
[0]02CC.03E4::2012-01-04 09:29:50.309 [Microsoft-Windows-WWAN-SVC-EVENTS]Account Management: Devnode create/update started.
[0]02CC.03E4::2012-01-04 09:29:50.309 [Microsoft-Windows-WWAN-SVC-EVENTS]Account Management: Devnode create/update finished.
[0]02CC.03E4::2012-01-04 09:29:50.309 [Microsoft-Windows-WWAN-SVC-EVENTS]Account Management: Account updater finished for network interface {7a0a0dce-0a51-471a-8c16-6e767cd0b861}.
Poznámka
V druhém příkladu neexistují žádné položky pro Vytvoření/aktualizace úložiště dat spuštěné nebo Vytvoření/aktualizace úložiště dat dokončeno. Vzhledem k tomu, že informace uložené v SIM kartě jsou pro proces správy účtů důležité, zařízení, které nemá SIM kartu, nebude mít potřebná metadata.
Pokud byl hardware úspěšně zpracován, ale vaše logo nebo název se v seznamu sítí nezobrazují, může se jednat o problém s balíčkem metadat. To je možné prozkoumat pomocí položek úlohy analyzátoru v protokolu. Chcete-li tyto položky najít, vyhledejte parser-Task. Položky protokolu pro úspěšnou analýzu obvykle vypadají takto:
[0]0DA8.0A2C::2012-01-04 09:22:32.007 [Microsoft-Windows-Mobile-Broadband-Experience-Parser-Task]Parser task started.
[0]0DA8.0A2C::2012-01-04 09:22:32.030 [Microsoft-Windows-Mobile-Broadband-Experience-Parser-Task]Parsing metadata for device container with id "{972238E7-36F4-11E1-BC81-00155DE96B01}" for culture "en-US".
[0]0DA8.0A2C::2012-01-04 09:22:32.297 [Microsoft-Windows-Mobile-Broadband-Experience-Parser-Task]Starting parse of mobile broadband service information file.
[0]0DA8.0A2C::2012-01-04 09:22:32.297 [Microsoft-Windows-Mobile-Broadband-Experience-Parser-Task]Metadata package contains no data for culture "en-US". Using fallback data.
[0]0DA8.0A2C::2012-01-04 09:22:32.356 [Microsoft-Windows-Mobile-Broadband-Experience-Parser-Task]Finished parse of mobile broadband service information file.
[0]0DA8.0A2C::2012-01-04 09:22:32.356 [Microsoft-Windows-Mobile-Broadband-Experience-Parser-Task]Starting update of stored network account information.
[0]0DA8.0A2C::2012-01-04 09:22:32.377 [Microsoft-Windows-Mobile-Broadband-Experience-Parser-Task]The mobile broadband account now contains service provider information.
[0]0DA8.0A2C::2012-01-04 09:22:32.378 [Microsoft-Windows-Mobile-Broadband-Experience-Parser-Task]Finished update of stored network account information.
[0]0DA8.0A2C::2012-01-04 09:22:32.378 [Microsoft-Windows-Mobile-Broadband-Experience-Parser-Task]Applying WWAN profiles for service provider Contoso GSM.
[0]0DA8.0A2C::2012-01-04 09:22:32.378 [Microsoft-Windows-Mobile-Broadband-Experience-Parser-Task]Starting creation and/or update of WWAN profiles.
[0]02CC.0CD0::2012-01-04 09:22:32.512 [Microsoft-Windows-WWAN-SVC-EVENTS]WWAN Service event: Profile Update Notification received
[0]02CC.0CD0::2012-01-04 09:22:32.519 [Microsoft-Windows-WWAN-SVC-EVENTS]WWAN Service event: Complete Scanning
[0]02CC.0CD0::2012-01-04 09:22:32.519 [Microsoft-Windows-WWAN-SVC-EVENTS]WWAN Service event: WWAN Interface information
[0]02CC.0CD0::2012-01-04 09:22:32.586 [Microsoft-Windows-WWAN-SVC-EVENTS]WWAN Service event: Profile Update Notification received
[0]02CC.0CD0::2012-01-04 09:22:32.651 [Microsoft-Windows-WWAN-SVC-EVENTS]WWAN Service event: Profile Update Notification received
[0]0DA8.0A2C::2012-01-04 09:22:32.659 [Microsoft-Windows-Mobile-Broadband-Experience-Parser-Task]Finished creation and/or update of WWAN profiles.
[0]0DA8.0A2C::2012-01-04 09:22:32.659 [Microsoft-Windows-Mobile-Broadband-Experience-Parser-Task]WWAN profiles applied successfully for service provider Contoso GSM.
[0]0DA8.0A2C::2012-01-04 09:22:32.659 [Microsoft-Windows-Mobile-Broadband-Experience-Parser-Task]Adding trusted provisioning certificates for service provider Contoso GSM.
[0]0DA8.0A2C::2012-01-04 09:22:32.659 [Microsoft-Windows-Mobile-Broadband-Experience-Parser-Task]Starting setting of trusted certificates for network provisioning.
[0]0DA8.0A2C::2012-01-04 09:22:33.016 [Microsoft-Windows-Mobile-Broadband-Experience-Parser-Task]Finished setting of trusted certificates for network provisioning.
[0]0DA8.0A2C::2012-01-04 09:22:33.016 [Microsoft-Windows-Mobile-Broadband-Experience-Parser-Task]Trusted provisioning certificates added successfully for service provider Contoso GSM.
[0]0DA8.0A2C::2012-01-04 09:22:33.017 [Microsoft-Windows-Mobile-Broadband-Experience-Parser-Task]Parser task finished.
[0]0DA8.0A2C::2012-01-04 09:22:33.017 [Microsoft-Windows-Mobile-Broadband-Experience-Parser-Task]MbaeParserTask completed successfully.
Tyto protokoly ukazují, že soubor MobileBroadbandInfo.xml byl správně zpracován, že úkol analyzátoru použil profily WWAN (společně se záznamem služby WWAN, který úspěšně aktualizoval profily) a že úkol analyzátoru nastavil důvěryhodné zřizovací certifikáty uvedené v MobileBroadbandInfo.xml.
Pokud některá část procesu selhala, zaprotokoluje se tato chyba. Pokud například kontrola digitálního podpisu v souboru ikony poskytovatele služeb selže, položky protokolu obvykle vypadají takto:
[0]0F24.0C70::2012-01-04 10:09:49.271 [Microsoft-Windows-Mobile-Broadband-Experience-Parser-Task]Parser task started.
[0]0F24.0C70::2012-01-04 10:09:49.288 [Microsoft-Windows-Mobile-Broadband-Experience-Parser-Task]Parsing metadata for device container with id "{97223B34-36F4-11E1-BC81-00155DE96B01}" for culture "en-US".
[0]0F24.0C70::2012-01-04 10:09:49.483 [Microsoft-Windows-Mobile-Broadband-Experience-Parser-Task]Starting parse of mobile broadband service information file.
[0]0F24.0C70::2012-01-04 10:09:49.483 [Microsoft-Windows-Mobile-Broadband-Experience-Parser-Task]Metadata package contains no data for culture "en-US". Using fallback data.
[0]0F24.0C70::2012-01-04 10:09:49.547 [Microsoft-Windows-Mobile-Broadband-Experience-Parser-Task]Finished parse of mobile broadband service information file.
[0]0F24.0C70::2012-01-04 10:09:49.547 [Microsoft-Windows-Mobile-Broadband-Experience-Parser-Task]Starting update of stored network account information.
[0]0F24.0C70::2012-01-04 10:09:49.688 [Microsoft-Windows-Mobile-Broadband-Experience-Parser-Task]Digital signature verification failed for file "c:\programdata\microsoft\windows\devicemetadatacache\dmrccache\en-us\B68264FF-E4D1-49B1-AB5F-2B9C1C16EF5D\ServiceInformation\ContosoBroadband.ico".
[0]0F24.0C70::2012-01-04 10:09:49.690 [Microsoft-Windows-Mobile-Broadband-Experience-Parser-Task]Finished update of stored network account information.
[0]0F24.0C70::2012-01-04 10:09:49.692 [Microsoft-Windows-Mobile-Broadband-Experience-Parser-Task]Parser task finished.
[0]0F24.0C70::2012-01-04 10:09:49.692 [Microsoft-Windows-Mobile-Broadband-Experience-Parser-Task]MbaeParserTask did not complete successfully. Error is 0x80070306: One or more errors occurred while processing the request.
Protože je normální, aby úloha analyzátoru běžela vícekrát, může se zobrazit více než jedna sada položek protokolu [Microsoft-Windows-Mobile-Broadband-Experience-Parser-Task]
. V tomto případě jsou sady položek obvykle stejné – pokud nejsou stejné, může to znamenat občasný problém.
Další zdroje informací
Další informace o mobilním širokopásmovém připojení ve Windows 8.1 a Windows 10 najdete na následujících odkazech: