Dev Guide Creating Mobile Operator Apps PTB

Guia de desenvolvimento para criar
aplicativos de operadoras mveis

quinta-feira, 31 de maio de 2012
Resumo
O aplicativo estilo Metro de operadora mvel um aspecto essencial da experincia
do operador do Windows 8. Este documento fornece informaes sobre como
comear a desenvolver um aplicativo estilo Metro de operadora mvel. Ele traz
diretrizes sobre a criao de metadados de servio para personalizar determinados
elementos do Windows 8. Ele parte do pressuposto de que o leitor j conhece a
banda larga mvel do Windows 8.
Estas informaes aplicam-se a estes sistemas operacionais:
Windows 8 Release Preview

As referncias e os recursos descritos aqui esto listados no final deste documento.
A verso atualizada deste documento mantida na Web, em:
Guia de desenvolvimento para criar aplicativos de operadoras mveis

Aviso de iseno de responsabilidade: Este documento fornecido "na forma em que se encontra". As
informaes e opinies expressas neste documento, incluindo URLS e outras referncias de sites de
Internet, podem ser alteradas sem aviso prvio. Algumas informaes se referem ao produto de pr-
lanamento, que pode ser modificado significativamente antes de seu lanamento comercial. A Microsoft
no oferece qualquer garantia, expressa ou implcita, em relao s informaes fornecidas aqui. Voc se
responsabiliza por us-lo. Alguns exemplos representados aqui so fornecidos apenas para ilustrao e
so fictcios. Nenhuma associao ou relao real pretendida ou deve ser inferida.
Este documento no lhe concede nenhum direito legal a qualquer propriedade intelectual de qualquer
produto Microsoft. Voc pode copiar e usar esse documento para fins de referncia interna.
2012 Microsoft. Todos os direitos reservados.

Guia de desenvolvimento para criar aplicativos de operadoras mveis - 2
Histrico do documento
Data Alterar
tera-feira, 28 de
fevereiro de 2012
Primeira publicao
quinta-feira, 31 de
maio de 2012
Atualizaes para refletir a alterao do nome "aplicativo de
dispositivo estilo Metro para banda larga mvel" para "operadora
mvel"

Contedo
Introduo ...................................................................................................................... 3
Guia de Desenvolvimento Passo a Passo ....................................................................... 3
Etapa 1: Instale o Windows 8 e as ferramentas ........................................................ 3
Etapa 2: Selecionar o certificado de editor correto ................................................... 4
Criar a conta de desenvolvedor e o perfil do aplicativo na Windows Store ......... 4
Criar um certificado de editor alternativo no Visual Studio .................................. 4
Instalando o certificado de editor alternativo em outros PCs .............................. 5
Etapa 3: Adicionar campos obrigatrios a package.appxmanifest ............................ 5
Se voc estiver tentando executar o aplicativo de exemplo API de Banda Larga
Mvel ..................................................................................................................... 5
Se voc estiver desenvolvendo seu prprio aplicativo para dispositivo estilo
Metro ..................................................................................................................... 5
Etapa 4: Habilitar a assinatura de teste no Windows 8 ............................................. 6
Etapa 5: Criar pacote de metadados de servio usando o Mobile Broadband
Metadata Authoring Wizard (Assistente para Criao de Metadados de Banda
Larga Mvel) .............................................................................................................. 6
Etapa 6: Instalar o pacote de metadados de servio ................................................. 7
Etapa 7: Conectar ou habilitar o dispositivo de banda larga mvel certificado para o
Windows 8 ................................................................................................................. 7
Etapa 8: Comear a desenvolver um aplicativo para dispositivo estilo Metro para
operadoras de rede mveis ....................................................................................... 7
Testando e solucionando problemas em seu pacote e aplicativo ................................. 7
Verificando se os metadados de servio esto em conformidade com o esquema . 7
Instalando pacotes de metadados no repositrio de metadados do dispositivo ..... 8
Verificando se os metadados foram corretamente instalados ................................. 8
Forando uma atualizao de metadados............................................................. 8
Verificando o cache de metadados ....................................................................... 9
Verificando o Registro ........................................................................................... 9
Verificando logs de WWAN ................................................................................. 11
Erros de acesso negado ....................................................................................... 11
MobileBroadbandAccountAvailableNetworkAccountIds retorna uma lista vazia12
Alguns cenrios de depurao de aplicativos .......................................................... 15
Erros de acesso negado ....................................................................................... 15
MobileBroadbandAccount.AvailableNetworkAccountIds retorna uma lista vazia16
Coletando os logs de WWAN ................................................................................... 16
Recursos ....................................................................................................................... 17

Introduo
Os aplicativos para dispositivos estilo Metro para banda larga mvel so um novo
desenvolvimento no Windows 8 que permitem que operadoras de rede mveis
forneam um aplicativo conectado ao seu respectivo servio e que
automaticamente baixado para o usurio quando o servio detectado pela primeira
vez. Com o fornecimento de um aplicativo para dispositivo estilo Metro, as
operadoras de rede mveis dispem de uma oportunidade nica de mostrar a
funcionalidade do servio. Para obter instrues gerais sobre aplicativos para
dispositivos estilo Metro para banda larga mvel, veja Viso geral de banda larga
mvel no Windows 8.
Para poder acessar a API de conta de banda larga mvel, um aplicativo para
dispositivo estilo Metro deve ter um pacote de metadados de servio associado a ele.
Este documento inclui como usar o Device Metadata Authoring Wizard (Assistente
para Criao de Metadados de Dispositivo) para criar um pacote de metadados de
servio para um aplicativo para dispositivo estilo Metro.
Este white paper discute o processo passo a passo para comear a desenvolver
aplicativos para dispositivos estilo Metro para banda larga mvel. Presume-se que o
leitor esteja familiarizado com o fluxo de trabalho de desenvolvimento de aplicativos
para dispositivos estilo Metro para banda larga mvel.
Guia de Desenvolvimento Passo a Passo
Este white paper abrange as etapas a seguir para comear a desenvolver aplicativos
para dispositivos estilo Metro para banda larga mvel:
1. Instale o Windows 8 e as ferramentas.
2. Selecione o certificado de editor atual (crie uma conta de desenvolvedor e um
perfil do aplicativo na Windows Store ou crie um certificado de editor
alternativo).
3. Adicione os campos obrigatrios ao arquivo package.appxmanifest do aplicativo.
4. Habilite a assinatura de teste no Windows 8.
5. Crie um pacote de metadados de servio usando o Device Metadata Authoring
Wizard (Assistente para Criao de Metadados de Dispositivo).
6. Instale o pacote de metadados de servio.
7. Conecte ou habilite um dispositivo de banda larga mvel certificado para o
Windows 8.
8. Comece a desenvolver um aplicativo para dispositivo estilo Metro para
operadoras de rede mveis.
Etapa 1: Instale o Windows 8 e as ferramentas
Alm de instalar o Windows 8, instale o Visual Studio 11 Professional ou Ultimate e o
Kit de Driver do Windows (WDK).
O Visual Studio 11 Professional ou Ultimate e o WDK podem ser baixados com uma
assinatura do MSDN. O Device Metadata Authoring Wizard (Assistente para Criao
de Metadados de Dispositivo) est localizado no WDK e requer o Visual Studio 11
Professional ou Ultimate (o WDK no compatvel com a edio Visual Studio 11
Express).
Link para download no MSDN: http://msdn.microsoft.com/en-
us/windows/hardware/br259105
Observao: No conecte nem habilite ainda o dispositivo de banda larga mvel.
Conecte ou habilite o dispositivo de banda larga mvel depois de criar e instalar
metadados de servio.
Etapa 2: Selecionar o certificado de editor correto
Ns recomendamos criar uma conta de desenvolvedor e um perfil do aplicativo na
Windows Store antes de voc comear a trabalhar em seu aplicativo, mas isso no
obrigatrio. Se nenhum certificado de editor da Windows Store estiver disponvel no
momento, voc pode criar um certificado de editor alternativo.
Criar a conta de desenvolvedor e o perfil do aplicativo na Windows
Store
So necessrios uma conta de desenvolvedor e um perfil do aplicativo na Windows
Store. Voc vai precisar do nome do editor e do nome do pacote usados no perfil de
seu aplicativo ao criar o manifesto do aplicativo e os metadados do dispositivo nas
etapas subsequentes. Veja Antes de voc comear a trabalhar em seu aplicativo para
saber mais sobre como criar um perfil de aplicativo.
Observe o seguinte:
Crie o perfil de repositrio antes de comear a gravar seu aplicativo para
dispositivo estilo Metro de forma que voc tenha o nome do editor e do pacote
prontos para as etapas subsequentes.
O nome do pacote expira quando o aplicativo no enviado dentro de um ano.
Escolha um bloco de aplicativo e um nome que tenha uma conexo forte com seu
servio.
O aplicativo deve ser adequado para todas as idades.
Ele deve ser comercializado gratuitamente.
Criar um certificado de editor alternativo no Visual Studio
Execute as etapas a seguir se a ID e o certificado de editor da conta de desenvolvedor
da Windows Store no estiverem disponveis (por exemplo, em um ambiente de
teste).
Crie um certificado de editor alternativo e os metadados de dispositivo com um
atributo de nome de editor correspondente. Por padro, o nome do editor o nome
de usurio da conta do Windows (por exemplo, CN=johnsmith). Ao criar um
certificado de editor alternativo, voc pode criar metadados de dispositivo uma vez e
us-los em vrios PCs de desenvolvimento. Ser preciso instalar o certificado de
editor alternativo em cada PC no qual voc pretenda realizar atividades de
desenvolvimento. Para saber com mais detalhes como criar um certificado, veja
Assinando um pacote.
O certificado de editor alternativo criado armazenado como
<NomedoAplicativo>_TemporaryKey.pfx na raiz do diretrio do projeto (por
exemplo, WinWebApp1_TemporaryKey.pfx).
Instalando o certificado de editor alternativo em outros PCs
Para facilitar o teste de seu aplicativo e dos metadados de dispositivo em PCs
separados, o certificado de editor precisa ser instalado em todos os PCs. Instale o
certificado no repositrio Autoridades de Certificao Raiz Confiveis. Todos os
certificados assinados com o certificado nesse ponto so confiveis pelo computador.
Por isso, exclua o certificado do repositrio assim que no precisar mais dele.
Para saber com mais detalhes como usar um certificado existente, veja Assinando um
pacote

Etapa 3: Adicionar campos obrigatrios a package.appxmanifest
Se voc estiver tentando executar o aplicativo de exemplo API de
Banda Larga Mvel
Se voc estiver tentando executar o aplicativo estilo Metro de exemplo da API de
banda larga mvel disponvel em Exemplo de gerenciamento de conta e dispositivo
de banda larga mvel, ignore a prxima etapa.
Se voc estiver desenvolvendo seu prprio aplicativo para dispositivo
estilo Metro
Ao desenvolver o aplicativo para dispositivo estilo Metro no Visual Studio, edite o
seguinte em package.appxmanifest:
Edite o nome do pacote e o editor para que correspondam queles usados no
perfil do aplicativo da Windows Store.
Edite a ID de aplicativo. Trata-se do atributo da ID do elemento <Application>.
Escolha um certificado de editor que corresponda ao nome do editor no
manifesto, clicando em Escolher Certificado na guia Empacotamento no Visual
Studio.
Declare o identificador da interface do dispositivo de banda larga mvel
adicionando o elemento XML a seguir como filho do elemento <Capabilities> no
appxmanifest do aplicativo:
<DeviceCapability Name="BFCD56F7-3943-457F-A312-2E19BB6DC648" />

Arquivo package.appxmanifest de exemplo do exemplo API de Banda Larga Mvel
<?xml version="1.0" encoding="utf-8"?>
<Package
xmlns="http://schemas.microsoft.com/appx/2010/manifest">
<Identity Name="Microsoft.SDKSamples.MobileBroadband.JS"
Version="1.0.0.0" Publisher="CN=Microsoft Corporation,
O=Microsoft Corporation, L=Redmond, S=Washington, C=US" />

...
<Capabilities>

<DeviceCapability Name="BFCD56F7-3943-457F-A312-
2E19BB6DC648" />
</Capabilities>
<Applications>
<Application Id="Microsoft.SDKSamples.Mobilebroadband"
StartPage="default.html">

...

</Application>
</Applications>
</Package>

Etapa 4: Habilitar a assinatura de teste no Windows 8
necessrio habilitar a assinatura de teste para que o Windows reconhea
metadados de dispositivos no assinados.
De um prompt de comando com privilgios elevados, execute:
bcdedit set testsigning on
Reinicie o computador para que a alterao seja aplicada.
Etapa 5: Criar pacote de metadados de servio usando o Mobile
Broadband Metadata Authoring Wizard (Assistente para Criao de
Metadados de Banda Larga Mvel)
O Mobile Broadband Metadata Authoring Wizard (Assistente para Criao de
Metadados de Banda Larga Mvel) a forma recomendada de criar pacotes de
metadados. Para obter instrues passo a passo, veja Usando o Mobile Broadband
Metadata Authoring Wizard (Assistente para Criao de Metadados de Banda Larga
Mvel).
Observao: Algumas propriedades de metadados so necessrias, enquanto outras
so opcionais. Para saber mais detalhes sobre propriedades de metadados, veja
Referncia a esquemas de pacotes de metadados de servios para Windows 8.
Observao: os metadados de servio permitem a habilitao de contas de usurio
padro para executar operaes de desbloqueio de PIN em cartes SIM de banda
larga mvel, ao contrrio do Mobile Broadband Metadata Authoring Wizard
(Assistente para Criao de Metadados de Dispositivo). Para saber mais detalhes de
como editar os metadados de servio para especificar que usurios padro tenham
permisso para executar essa funo, veja Referncia de esquemas de pacotes de
metadados de servios para Windows 8.
Nome do pacote
ID de aplicativo
funcionalidade do
dispositivo
Etapa 6: Instalar o pacote de metadados de servio
Instale os metadados de dispositivo copiando-os para
%ProgramData%\Microsoft\Windows\DeviceMetadataStore\<lang>
(por exemplo, c:\programdata\microsoft\windows\deviceDevice Metadatastore\pt-
br)
Esta etapa no necessria se a opo Copy packages to your systems local Device
Metadata store (Copiar pacotes para o repositrio Metadados de Dispositivo local
do sistema) foi selecionada na ltima etapa do Metadata Authoring Wizard
(Assistente para Criao de Metadados).
Etapa 7: Conectar ou habilitar o dispositivo de banda larga mvel
certificado para o Windows 8
Para aproveitar todas as vantagens da plataforma de banda larga do Windows
Mobile, o dispositivo de banda larga mvel deve atender aos requisitos da
Certificao de Hardware do Windows 8. Uma descrio abrangente dos requisitos da
Certificao de Hardware est disponvel em Requisitos da Certificao de Hardware
do Windows 8.
Diretrizes detalhadas para que operadoras mveis desenvolvam especificaes de
hardware de banda larga mvel, bem como diretrizes a serem comunicadas para
parceiros de hardware, so discutidas em Diretrizes de hardware para operadoras
mveis para Windows 8.
Etapa 8: Comear a desenvolver um aplicativo para dispositivo estilo
Metro para operadoras de rede mveis
Para saber mais sobre como desenvolver um aplicativo para dispositivo estilo Metro,
veja Viso geral da API do Tempo de Execuo do Windows de banda larga mvel.
Testando e solucionando problemas em seu pacote e aplicativo
Ao desenvolver seu pacote de metadados, voc precisar test-lo. A forma mais fcil
de fazer isso copi-lo para o diretrio do repositrio de metadados do dispositivo.
Verificando se os metadados de servio esto em conformidade com o
esquema
Os metadados que no contm campos obrigatrios no funcionam corretamente.
Algumas propriedades de metadados so necessrias, enquanto outras so opcionais.
Se voc se deparar com problemas de instalao de metadados, verifique se os
metadados esto em conformidade com o esquema de metadados de servio.
Para saber mais detalhes sobre propriedades de metadados, veja Referncia a
esquemas de pacotes de metadados de servios para Windows 8.
Instalando pacotes de metadados no repositrio de metadados do
dispositivo
A ferramenta para criao de metadados faz isso para voc, mas se voc precisar
executar essa ao manualmente, copie o arquivo *.devicemetadata-ms que voc
criou para
%programdata%\Microsoft\Windows\DeviceMetadataStore\culture
em que culture o cdigo da cultura atual de seu computador de teste (por
exemplo, en-us ou pt-br). O nome do arquivo do pacote de metadados deve ter o
formato GUID.devicemetadata-ms (por exemplo, {AC8CBC46-2405-40A7-8C3E-
72A0C3DA0A24}.devicemetadata-ms), ou ele ser ignorado. Quando o
dispositivo conectado pela primeira vez, o arquivo de metadados analisado
automaticamente, mas, depois disso, as atualizaes dos metadados so
automaticamente manipuladas somente aps um longo atraso para manter baixo o
consumo de energia. possvel forar manualmente uma atualizao; entretanto,
veja Forando uma atualizao de metadados para obter detalhes.
Verificando se os metadados foram corretamente instalados
A forma mais fcil de fazer isso aguardar alguns segundos, abrir o submenu Redes
Disponveis e procurar sua rede de banda larga mvel. Se a rede estiver listada com o
nome e o cone que voc usou no arquivo ServiceInfo.xml do pacote de metadados, o
pacote foi analisado corretamente. Se, porm, voc estiver atualizando um pacote de
metadados que j tenha o mesmo nome e cone, ou se o nome ou o cone no tiver
sido exibido no submenu aps cerca de um minuto em um computador
descarregado, ser preciso investigar um pouco mais.
Forando uma atualizao de metadados
Os metadados e os sistemas de aplicativos complementares possuem muitas partes
mveis, algumas das quais dependem de acesso rede, que pode falhar e deixar tudo
em um estado inconsistente. Quando isso acontece, o usurio pode se ver em uma
situao em que os metadados no esto instalados, quando deveriam, ou o
aplicativo complementar no est instalado. O sistema tentar remediar novamente
a situao de forma peridica, mas, para manter os custos de energia baixos, as
novas tentativas no so muito frequentes (na ordem de apenas algumas vezes ao
dia). Se voc no quer esperar muito, ou se est desenvolvendo um pacote de
metadados e fazendo alteraes frequentes nele, possvel forar manualmente uma
atualizao para que ocorra imediatamente. Para fazer isso, a pessoa precisa
executar o painel de controle clssico, abrir Dispositivos e Impressoras e selecionar
Atualizar no menu Exibir ou pressionar a tecla F5. Os metadados sero analisados
novamente, e os eventos em segundo plano sero registrados de novo. Observe que,
se os metadados j tiverem sido analisados com xito, o sistema tratar disso como
uma atualizao de metadados, e seu pacote de metadados precisar ter um GUID
diferente no nome do arquivo.
Verificando o cache de metadados
Se voc tiver forado uma atualizao de metadados, mas no adiantou, a prxima
etapa verificar se o pacote de metadados vlido e se possui as IDs de hardware
corretas. No Windows Explorer ou em um prompt de comando, v para o diretrio:
%programdata%\Microsoft\Windows\DeviceMetadataCache\dmrccache\culture
em que culture o cdigo da cultura atual de seu computador de teste (por
exemplo en-us ou pt-br) e veja se h um diretrio com o mesmo nome (sem a
extenso .devicemetadata-ms) que seu pacote de metadados. Se no houver, isso
pode ter um dentre quatro significados:
O pacote de metadados est corrompido (se voc acabou de cri-lo, isso
improvvel).
O pacote de metadados no tem as IDs de hardware corretas.
O dispositivo de banda larga mvel que voc est usando no est em um estado
no qual os metadados podem ser baixados para ele, ou voc conectou o
dispositivo antes de copiar o pacote de metadados.
Houve um problema ao verificar a assinatura digital no pacote de metadados; ao
desenvolver o aplicativo, isso geralmente causado porque a assinatura de teste
no est habilitada em seu computador de teste (a assinatura de teste
habilitada com a execuo de bcdedit /set testsigning on em um prompt de
comandos com privilgios elevados, seguida da reinicializao)

Se voc tem certeza de que o pacote no est corrompido e que voc conectou
primeiro o dispositivo de banda larga mvel depois de copiar o pacote de metadados,
confira os dados inseridos na ferramenta para criao de metadados. Especialmente
no caso de intervalos IMSI, muito fcil digitar 0s ou 9s demais ou de menos. Se,
depois de verificar as diferentes IDs, ainda no existir diretrio no cache de
metadados do dispositivo, ou se voc tiver copiado seu pacote de metadados depois
de conectar ou ligar primeiro o dispositivo de banda larga mvel, hora de examinar
o Registro.
Verificando o Registro
Execute Regedit.exe e v para
HKLM\SOFTWARE\Microsoft\WwanSvc\MobileBroadbandAccounts. (Os avisos de
iseno de responsabilidade usuais, sobre alterao de dados no Registro, se aplicam;
em particular, no exclua, sob circunstncia alguma, a chave do Registro
MobileBroadbandAccounts. O Windows no a recria, e voc danificar o recurso.) Na
chave do Registro, podero existir duas outras chaves: Contas e
NetworkInterfaceBindings. Elas no existem por padro e so criadas
automaticamente quando um dispositivo de banda larga mvel inserido ou ligado
pela primeira vez. Se elas no existirem e se voc j tiver conectado ou ligado seu
adaptador de banda larga mvel, isso significa que voc precisa investigar mais; veja
Verificando logs de WWAN. Se essas chaves existirem, expanda a chave Contas no
modo de exibio de rvore. Voc ver uma ou mais chaves do Registro dentro dela,
com nomes que se assemelham a GUIDs. A Figura 1 mostra como uma dessas chaves
se parece quando est totalmente populada.

Figura 1: Entradas do Registro de uma conta de banda larga mvel analisada
Se a chave do Registro for semelhante ao exemplo (os nomes de valor variam
ligeiramente dependendo de a conta estar em uma rede GSM ou CDMA) e voc no
vir o cone no submenu de redes disponveis, examine os logs de evento; veja
Verificando logs de WWAN". Se, por outro lado, s existirem alguns valores
(especificamente, nenhum valor ServiceProviderIconPath ou
ServiceProviderFriendlyName, veja Figura 2), isso significa que o adaptador de banda
larga mvel foi inserido antes de o pacote de metadados ser copiado para o
repositrio de metadados do dispositivo (isso tambm acontece se o pacote de
metadados estiver corrompido ou se as IDs de hardware estiverem incorretas, mas,
nesse caso, tambm no haveria diretrio no cache de metadados do pacote, veja
Verificando o cache de metadados).

Figura 2: Entradas do Registro de uma conta de banda larga mvel no analisada
Para remediar uma situao na qual voc conectou ou ligou o dispositivo antes de
copiar o pacote de metadados para o repositrio de metadados, verifique se o
dispositivo est conectado e/ou ligado, v para o Painel de Controle clssico, abra
Dispositivos e Impressoras e pressione F5 ou selecione Atualizar no menu Exibir. Isso
forar a ocorrncia de todo o processo de instalao de metadados.
Verificando logs de WWAN
Se nem a chave do Registro Contas nem a chave do Registro
NetworkInterfaceBindings estiver em
HKLM\SOFTWARE\Microsoft\WwanSvc\MobileBroadbandAccounts, ou se houver
entradas, mas que nunca so totalmente populadas, ser preciso examinar os logs de
WWAN para conferir o que pode ter sado errado. As etapas a seguir restauram as
configuraes para um estado conhecido:
1. Desconecte/desligue seu dispositivo de banda larga mvel.
2. Exclua estas chaves do Registro:

HKLM\SOFTWARE\Microsoft\WwanSvc\MobileBroadbandAccounts\Accounts
HKLM\SOFTWARE\Microsoft\WwanSvc\MobileBroadbandAccounts\NetworkI
nterfaceBindings

No exclua:
HKLM\SOFTWARE\Microsoft\WwanSvc\MobileBroadbandAccounts
3. Siga as etapas na seo Alguns cenrios de depurao de aplicativos

Erros de acesso negado
Esta seo contm ajuda sobre alguns problemas que podem ser complicados para os
desenvolvedores.
A API da Conta de Banda Larga Mvel uma API privilegiada, e os aplicativos
complementares de banda larga mvel so associados a pacotes de metadados. O
motivo que essa API permite acesso a informaes identificveis pessoalmente,
como ICCIDs e IDs de conta de rede. Alm disso, ao tornar a API privilegiada e ao
associar aplicativos a pacotes de metadados, aumentamos a privacidade dos usurios
limitando o acesso API. Como resultado, voc poder encontrar excees de Acesso
Negado ao desenvolver um aplicativo complementar de banda larga mvel. Para
evitar essas excees, faa o seguinte:
1. Adicione a linha a seguir ao elemento XML <Capabilities> do arquivo
appxmanifest do seu aplicativo:
2. Verifique se seu aplicativo est listado como privilegiado no arquivo
Softwareinfo.xml do pacote de metadados.
a. Veja se o nome do pacote, o nome do editor e a ID de aplicativo dos
metadados de servio correspondem s informaes no arquivo
package.appxmanifest do aplicativo estilo Metro.
b. Verifique se o nome do editor corresponde ao certificado de editor
instalado no PC.

Se voc tiver certeza de que seguiu essas etapas, mas ainda assim obtm erros,
examine os logs de WWAN para saber o motivo exato da exceo gerada (veja
Coletando os logs de WWAN na pgina 15 para obter instrues). Procure no log
entradas que contenham o nome do mtodo ou a propriedade que est gerando a
exceo. O motivo estar detalhado ali.
MobileBroadbandAccountAvailableNetworkAccountIds retorna uma lista
vazia
A propriedade esttica AvailableNetworkAccountIds da classe
MobileBroadbandAccount retorna as IDs que o mtodo esttico
CreateFromNetworkAccountId consome, o que significa que ela segue regras
similares quanto confiana do aplicativo. Entretanto, se seu aplicativo no for
confivel, a propriedade retornar uma coleo vazia, em vez de gerar uma exceo.
O motivo que os usurios podem ter contas de mais de uma operadora de rede no
computador, e o mtodo GetAllNetworkAccountIds retorna somente as IDs de conta
que o pacote de metadados do aplicativo tem permisso para ver (ou seja, as IDs de
conta para as quais o mtodo esttico CreateFromNetworkAccountId no gera uma
exceo de Acesso Negado). Se no houver nenhuma ID de conta qual o aplicativo
complementar tenha permisso de acesso, a coleo retornada ser vazia. Observe
que, como a propriedade AvailableNetworkAccountIds verifica se cada ID de conta
tem um dispositivo associado a ela no momento da recuperao, possvel que essa
propriedade retorne uma coleo vazia, mesmo se CreateFromNetworkAccountId
no tivesse gerado uma exceo de acesso negado. Isso ocorre quando nenhum
hardware de rede detectado, ou se o hardware de rede no tem um carto SIM
acessvel. Uma forma simples de determinar o motivo exato de por que a coleo
retornada estava vazia examinar os logs de WWAN (veja Coletando os logs de
WWAN na pgina 15 para obter instrues de como fazer isso). Depois de coletar os
logs, procure as entradas no arquivo de log de texto que contenham o texto
AvailableNetworkAccountIds. O motivo pelo qual nenhuma ID de conta foi
retornada estar descrito ali.
Alguns cenrios de depurao de aplicativos
desenvolvedores.
instalado no PC.
MobileBroadbandAccount.AvailableNetworkAccountIds retorna uma
lista vazia
Coletando os logs de WWANColetando os logs de WWAN
Para este tpico, existem dois tipos de entradas que so de interesse nos logs:
entradas de servio WWAN de gerenciamento de contas e entradas de tarefas de
analisador. O primeiro tpico pode ajudar a depurar problemas causados por
hardware de rede, e o segundo pode ajudar a depurar problemas com anlise de
dados. Considere no momento o primeiro tipo; veja a seguir como se geralmente
assemelham as entradas de log de uma rede que foi processada com xito:
[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}.
EVENTS]Account Management: Getting home provider ID from hardware device for
network interface {7A0A0DCE-0A51-471A-8C16-6E767CD0B861}. Provider ID is
"234567".
EVENTS]Account Management: Getting home provider name from hardware device
for network interface {7A0A0DCE-0A51-471A-8C16-6E767CD0B861}. Provider name
is "MS GSM".
EVENTS]Account Management: Network identity not recognized, assigning new
network account ID.
EVENTS]Account Management: Devnode create/update started.
EVENTS]Account Management: Devnode create/update finished.
EVENTS]Account Management: Data store create/update started.
EVENTS]Account Management: Data store create/update finished.
EVENTS]Account Management: Account updater finished for network interface
{7a0a0dce-0a51-471a-8c16-6e767cd0b861}.
Essas entradas podem ser encontradas no log pesquisando Gerenciamento de
contas. As mais importantes nesse caso so Data store create/update started
(Criao/atualizao de repositrio de dados iniciada) e Data store create/update
finished (Criao/atualizao de repositrio de dados concluda). Se essas entradas
estiverem presentes e no houver mensagens de erro entre elas, ento o hardware
est se comportando corretamente (o repositrio de dados ao qual est sendo feita
referncia so as chaves do Registro em Verificando o Registro). Por outro lado,
veja como geralmente se assemelham as entradas de gerenciamento de contas em
um dispositivo no qual o carto SIM foi removido:
[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}.
EVENTS]Account Management: Detected removal of SIM from device bound to
network interface {7A0A0DCE-0A51-471A-8C16-6E767CD0B861}.
EVENTS]Account Management: Devnode create/update started.
EVENTS]Account Management: Devnode create/update finished.
EVENTS]Account Management: Account updater finished for network interface
{7a0a0dce-0a51-471a-8c16-6e767cd0b861}.
Observe como no existem entradas para Data store create/update started
(Criao/atualizao de repositrio de dados iniciada) ou Data store create/update
finished (Criao/atualizao de repositrio de dados concluda). Como as
informaes armazenadas no SIM so cruciais para o processo de gerenciamento de
contas, um dispositivo sem o carto SIM no ter metadados associados a ele.
Se o hardware tiver sido processado com xito (ou seja, se havia entradas para Data
store create/update started (Criao/atualizao de repositrio de dados iniciada)
ou Data store create/update finished (Criao/atualizao de repositrio de dados
concluda) sem erros entre elas), mas o logotipo e/ou o nome de sua empresa ainda
assim no (so) exibido(s) no submenu Redes, pode haver um problema com o
pacote de metadados. Isso pode ser investigado usando as entradas de tarefa de
analisador no log. Para encontrar essas entradas, procure Parser-Task. Veja como
geralmente se assemelham as entradas de log de uma anlise bem-sucedida:
[0]0DA8.0A2C:: 2012 - 01 - 04 09:22:32.007 [Microsoft-Windows-Mobile-Broadband-
Experience-Parser-Task]Parser task started.
Experience-Parser-Task]Parsing metadata for device container with id
"{972238E7-36F4-11E1-BC81-00155DE96B01}" for culture "en-US".
Experience-Parser-Task]Starting parse of mobile broadband service
information file.
Experience-Parser-Task]Metadata package contains no data for culture "en-
US". Using fallback data.
Experience-Parser-Task]Finished parse of mobile broadband service
information file.
Experience-Parser-Task]Starting update of stored network account
information.
Experience-Parser-Task]The mobile broadband account now contains service
provider information.
Experience-Parser-Task]Finished update of stored network account
information.
Experience-Parser-Task]Applying WWAN profiles for service provider Contoso
GSM.
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
Service event: Complete Scanning
Service event: WWAN Interface information
Experience-Parser-Task]Finished creation and/or update of WWAN profiles.
Experience-Parser-Task]WWAN profiles applied successfully for service
provider Contoso GSM.
Experience-Parser-Task]Adding trusted provisioning certificates for service
provider Contoso GSM.
Experience-Parser-Task]Starting setting of trusted certificates for network
provisioning.
Experience-Parser-Task]Finished setting of trusted certificates for network
provisioning.
Experience-Parser-Task]Trusted provisioning certificates added successfully
for service provider Contoso GSM.
Experience-Parser-Task]Parser task finished.
Experience-Parser-Task]MbaeParserTask completed successfully.
Esses logs mostram que o arquivo MobileBroadbandInfo.xml foi corretamente
analisado, que a tarefa de analisador aplicou os perfis WWAN mencionados nele
(com o registro em log de que o servio WWAN pde atualizar os perfis com xito) e
que depois a tarefa de analisador definiu os certificados de provisionamento
confiveis mencionados em MobileBroadbandInfo.xml. Se alguma parte do processo
falha, a falha registrada em log. Por exemplo, veja como geralmente se assemelham
as entradas de log quando a verificao de assinatura digital falha no arquivo de
cone do provedor de servios (o erro est em negrito para clareza):
[0]0F24.0C70:: 2012 - 01 - 04 10:09:49.271 [Microsoft-Windows-Mobile-Broadband-
Experience-Parser-Task]Parser task started.
Experience-Parser-Task]Parsing metadata for device container with id
"{97223B34-36F4-11E1-BC81-00155DE96B01}" for culture "en-US".
Experience-Parser-Task]Starting parse of mobile broadband service
information file.
Experience-Parser-Task]Metadata package contains no data for culture "en-
US". Using fallback data.
Experience-Parser-Task]Finished parse of mobile broadband service
information file.
Experience-Parser-Task]Starting update of stored network account
information.
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".
Experience-Parser-Task]Finished update of stored network account
information.
Experience-Parser-Task]Parser task finished.
Experience-Parser-Task]MbaeParserTask did not complete successfully. Error
is 0x80070306: One or more errors occurred while processing the request.
Como normal que a tarefa de analisador seja executada mais de uma vez, talvez
voc veja mais de um conjunto de entradas de log [Microsoft-Windows-Mobile-
Broadband-Experience-Parser-Task]. Se isso ocorrer, os conjuntos de entradas sero
geralmente os mesmos, mas, se no forem, pode existir um problema intermitente.
Observe que, como o aplicativo complementar instalado pelo Windows Device
Software Manager, se todos os itens acima conferem (especificamente, se o logotipo
e o nome de sua empresa aparecem no submenu de redes), mas seu aplicativo no
instalado, veja [insira a URL para o guia de soluo de problemas DSM] para obter
mais ajuda.
Alguns cenrios de depurao de aplicativos
desenvolvedores.
instalado no PC.
MobileBroadbandAccount.AvailableNetworkAccountIds retorna uma
lista vazia
Coletando os logs de WWAN
Os logs de WWAN so um recurso de depurao valioso ao investigar por que os
metadados no foram instalados e ao depurar aplicativos complementares. O arquivo
de texto que voc gera depois de seguir as etapas nesta seo contm os dados
coletados de todos os estgios da pilha WWAN do Windows, incluindo mtodos da
API da Conta de Banda Larga Mvel do WinRT. Como as entradas de log so
agrupadas, possvel ver o fluxo de dados entre os diferentes componentes do
sistema enquanto diferentes tarefas so realizadas.
Para coletar os logs de WWAN, abra um prompt de comandos com privilgios
elevados, digite o comando a seguir no prompt e pressione Enter:
netsh trace start mbn

A resposta ser algo similar a isto:
Trace configuration:
-------------------------------------------------------------------
Status: Running
Trace File: C:\Users\test\AppData\Local\Temp\NetTraces\NetTrace.etl
Append: Desativada
Circular: On
Max Size: 250 MB
Report: Desativada

Neste ponto, execute a ao para a qual voc precisa de logs:
Se voc depurar problemas relacionadas ao aplicativo, execute a parte do
aplicativo que exibe o problema.
Para problemas com metadados, verifique se o dispositivo de banda larga
mvel est inserido e/ou ligado: v para o Painel de Controle clssico, abra
Dispositivos e Impressoras e pressione F5 ou selecione Atualizar no menu
Exibir. Aguarde 30 segundos at que os processos em segundo plano sejam
concludos.
Depois de concludos, no prompt de comandos com privilgios elevados que voc
abriu anteriormente, digite o seguinte e pressione Enter:
netsh trace stop

Esse procedimento demora vrios segundos (s vezes, dependendo das
circunstncias, um minuto ou mais) e exibe algo similar ao seguinte:
Correlating traces ... done
Generating data collection ... done
The trace file and additional troubleshooting information have been compiled as
"C:\Users\test\AppData\Local\Temp\NetTraces\NetTrace.cab".
File location = C:\Users\test\AppData\Local\Temp\NetTraces\NetTrace.etl
Tracing session was successfully stopped.

Finalmente, voc precisa converter o arquivo de rastreamento em um arquivo de
texto para leitura humana. Para fazer isso, digite o comando a seguir no prompt de
comandos com privilgios elevados, seguido de Enter (observe que o comando est
em uma nica linha, e a seo em negrito e itlico deve ser igual sada do valor
Local do arquivo pelo comando netsh trace stop):
netsh trace convert input=
"C:\Users\test\AppData\Local\Temp\NetTraces\NetTrace.etl" overwrite=yes

Isso funciona por alguns segundos (muito menos tempo que o comando anterior) e
exibe algo similar ao seguinte:
Input file: C:\Users\test\AppData\Local\Temp\NetTraces\NetTrace.etl
Dump file: C:\Users\test\AppData\Local\Temp\NetTraces\NetTrace.txt
Dump format: TXT
Report file: -
Generating dump ... done

O arquivo de log para leitura humana ser aquele listado em Dump file (Arquivo de
despejo); neste caso, C:\Users\test\AppData\Local\Temp\NetTraces\NetTrace.txt.
Abra o arquivo com Gravao ou Visual Studio (ele pode ficar muito grande para que
o Bloco de Notas o manipule corretamente).
Recursos
Viso geral da banda larga mvel no Windows 8
http://go.microsoft.com/fwlink/?linkid=242052
Preparando-se para desenvolver aplicativos de operadoras mveis
Referncia do esquema de pacote de metadados de servio do Windows 8
Diretrizes de hardware do Windows 8 para operadoras mveis
Viso geral da API de Tempo de Execuo do Windows de banda larga mvel
Enviando um aplicativo de operadora mvel
Exemplo da API de banda larga mvel
http://code.msdn.microsoft.com/windowsapps/Mobile-Broadband-API-Sample-
7debc1ff

Dev Guide Creating Mobile Operator Apps PTB

Uploaded by

Document Information

Copyright

Available Formats

Share this document

Share or Embed Document

Sharing Options

Did you find this document useful?

Is this content inappropriate?

Copyright:

Available Formats

Dev Guide Creating Mobile Operator Apps PTB

Uploaded by

Copyright:

Available Formats

Guia de desenvolvimento para criar

aplicativos de operadoras mveis

You might also like