StoreContext.GetAppAndOptionalStorePackageUpdatesAsync Método

public:
 virtual IAsyncOperation<IVectorView<StorePackageUpdate ^> ^> ^ GetAppAndOptionalStorePackageUpdatesAsync() = GetAppAndOptionalStorePackageUpdatesAsync;

/// [Windows.Foundation.Metadata.RemoteAsync]
IAsyncOperation<IVectorView<StorePackageUpdate>> GetAppAndOptionalStorePackageUpdatesAsync();

[Windows.Foundation.Metadata.RemoteAsync]
public IAsyncOperation<IReadOnlyList<StorePackageUpdate>> GetAppAndOptionalStorePackageUpdatesAsync();

function getAppAndOptionalStorePackageUpdatesAsync()

Public Function GetAppAndOptionalStorePackageUpdatesAsync () As IAsyncOperation(Of IReadOnlyList(Of StorePackageUpdate))

Retornos

Uma operação assíncrona que, após a conclusão bem-sucedida, retorna uma coleção de objetos StorePackageUpdate que representam os pacotes que têm atualizações disponíveis.

Atributos

RemoteAsyncAttribute

Exceções

Comentários

Para obter mais informações sobre como usar esse método, incluindo um exemplo de código, consulte Baixar e instalar atualizações de pacote para seu aplicativo.

Depois de chamar GetAppAndOptionalStorePackageUpdatesAsync para determinar quais pacotes têm atualizações disponíveis, você pode chamar RequestDownloadStorePackageUpdatesAsync para baixar os pacotes atualizados ou chamar RequestDownloadAndInstallStorePackageUpdatesAsync para baixar e instalar os pacotes atualizados.

Pré-requisitos e requisitos de ambiente

Para que esse método funcione corretamente, as seguintes condições devem ser atendidas:

• Microsoft Store aplicativo: o aplicativo Microsoft Store deve ser instalado e funcional no sistema.
• conta Microsoft: embora uma conta Microsoft de entrada não seja estritamente necessária para verificar se há atualizações, determinados cenários podem exigir autenticação.
• Store services: os serviços de licenciamento e atualização Microsoft Store devem estar em execução e acessíveis.
• Network conectividade: uma conexão de Internet ativa é necessária para se comunicar com o serviço Microsoft Store.

Compatibilidade do modo de acesso atribuído

Esse método pode ser usado no modo acesso atribuído (quiosque), mas as seguintes considerações se aplicam:

• A conta de acesso atribuída deve ter permissão para acessar Microsoft Store serviços.
• O acesso à rede deve ser configurado para permitir a comunicação com pontos de extremidade Microsoft Store.
• Alguns elementos da interface do usuário do Repositório podem ser restritos dependendo da configuração de acesso atribuída.

Recomendações de tratamento de erros

Ao chamar esse método, é recomendável implementar o tratamento de erros adequado:

try
{
    var updates = await storeContext.GetAppAndOptionalStorePackageUpdatesAsync();
    // Process updates
}
catch (System.Runtime.InteropServices.COMException ex)
{
    // Handle COM-related errors (e.g., threading issues)
}
catch (System.Exception ex)
{
    // Handle Store service errors (e.g., service unavailable)
    // Log the error and implement appropriate retry logic
}

Atualizar a disponibilidade

Depois de publicar uma atualização de aplicativo no Partner Center, pode haver um pequeno atraso entre quando o pacote passa na certificação e quando o método GetAppAndOptionalStorePackageUpdatesAsync reconhece que a atualização está disponível. A maioria das atualizações fica disponível em algumas horas, mas algumas etapas de publicação e distribuição podem levar mais tempo para serem concluídas em determinados casos.

Frequência de detecção

Essa API limita a frequência com que verifica se há novas atualizações. Quando um aplicativo chama o método com mais frequência do que a taxa permitida, o método retorna o último status conhecido em vez de executar uma nova verificação.

Os limites atuais são:

• Não mais do que uma verificação a cada 30 minutos.
• Não mais do que dez verificações em qualquer período de 24 horas.

Se um aplicativo exceder esses limites, o método continuará retornando o status anterior até que a janela de tempo aplicável seja aprovada.

Confira também

• Baixar e instalar atualizações de pacote para seu aplicativo
• Criação de pacotes opcionais e configuração de conjuntos relacionados