Observação
O acesso a essa página exige autorização. Você pode tentar entrar ou alterar diretórios.
O acesso a essa página exige autorização. Você pode tentar alterar os diretórios.
O código gerado está pronto para revisão, não está automaticamente pronto para ser enviado. Nesta etapa final, você pratica como detectar um erro plausível relacionado ao framework e verifica o Task Tally para além da compilação.
Testar deliberadamente o assistente
Inicie uma nova conversa com seu assistente para que ele não dependa das restrições de prompts anteriores. Pergunte:
Add a confirmation dialog before deleting a task from my Windows XAML app.
Show only the using directives and the dialog construction code.
Um assistente sem restrições pode retornar:
using Windows.UI.Xaml.Controls;
var dialog = new ContentDialog
{
Title = "Delete task?",
PrimaryButtonText = "Delete",
CloseButtonText = "Cancel"
};
Este é um namespace UWP.
ContentDialog também existe no WinUI 3, o que faz com que seja fácil não perceber o erro em uma revisão de código.
Para este projeto, o namespace deve ser:
using Microsoft.UI.Xaml.Controls;
var dialog = new ContentDialog
{
Title = "Delete task?",
PrimaryButtonText = "Delete",
CloseButtonText = "Cancel",
XamlRoot = this.XamlRoot
};
A URL de referência do ContentDialog do WinUI 3 inclui microsoft.ui.xaml.controls. A referência UWP de ContentDialog usa windows.ui.xaml.controls.
É por isso que "o tipo existe na documentação Windows" não é suficiente. Verifique a estrutura, o namespace, a versão e o modelo de aplicativo.
Usar uma verificação de estrutura para o código gerado
Quando o assistente adiciona uma API Windows, inspecione-a com estas perguntas:
| Verificação | O que procurar |
|---|---|
| Framework | É a documentação do WinUI 3 e do SDK do Aplicativo Windows? |
| Namespace | O código de interface do usuário usa Microsoft.UI.Xaml, e não Windows.UI.Xaml nem System.Windows? |
| Versão | A API está disponível na versão SDK do Aplicativo Windows referenciada pelo projeto? |
| Modelo de aplicativo | A API requer a identidade do pacote, um recurso de aplicativo ou inicialização de janela? |
| Threading | A chamada deve ser executada no thread da interface do usuário? A operação assíncrona é esperada? |
| UX | Há um controle ou padrão do WinUI interno para o cenário? |
| Accessibility | A interface do usuário gerada tem nomes, rótulos, acesso ao teclado e foco visível? |
| Evidência | Você compilou, executou e testou o fluxo alterado? |
Peça ao assistente para fornecer a URL do Learn que embasa sua escolha e, em seguida, acesse você mesmo essa URL.
Verificar contagem de tarefas
Execute um passe de verificação final:
- Exclua os dados locais do aplicativo ou comece com uma nova instalação. Confirme se o estado vazio é exibido e se a inserção apenas de espaços mantém a tarefa Adicionar desabilitada.
- Adicione várias tarefas, marque uma concluída e exclua outra. Confirme se a contagem restante é atualizada e se o item correto é removido.
- Reinicie o aplicativo. Confirme se os títulos da tarefa e os estados de conclusão foram restaurados.
- Adicione
if (System.Diagnostics.Debugger.IsAttached) throw new IOException("Test save failure.");como a primeira linha deTaskStorage.SaveAsync, recompile e execute o aplicativo no depurador. Acione o salvamento e confirme que oInfoBarinforme a falha em vez de um salvamento bem-sucedido. Em seguida, remova a condição temporária e recompile. - Navegue por todos os elementos interativos com Tab e Shift+Tab.
- Use um leitor de tela ou o Accessibility Insights para Windows para inspecionar nomes, funções e ordem de foco.
- Redimensione o aplicativo, teste temas claros, escuros e de contraste e compile para x64 sem avisos de compilador, XAML, associação ou analisador.
Saiba mais: Visão geral de acessibilidade e teste de acessibilidade.
Refine o prompt, não apenas o código
Se uma verificação falhar, salve a correção e o motivo no próximo prompt:
The generated code used Windows.UI.Xaml.Controls, which is the UWP
namespace. This project is WinUI 3. Replace it with the corresponding
Microsoft.UI.Xaml API, verify the API in the Windows App SDK reference,
build the x64 project, and explain why the original namespace was wrong.
Isso fornece ao assistente evidências úteis e reforça o limite do projeto. Para um projeto de vida mais longa, coloque restrições estáveis, como a estrutura, o modelo de empacotamento, a arquitetura de destino e o comando de build nas instruções do repositório que o assistente de codificação lê.
Próximas Etapas
Você criou um pequeno aplicativo WinUI 3 e praticou um fluxo de trabalho que pode reutilizar:
Perguntar → gerar → compilar → inspecionar → verificar → refinar
Continuar com:
- Crie seu primeiro aplicativo WinUI para uma introdução determinística e focada em código ao XAML, navegação e armazenamento de arquivos.
- Associação de dados, injeção de dependência e teste de unidade no WinUI para uma arquitetura MVVM maior.
- Galeria do WinUI 3 para verificar controles e padrões de interação em um exemplo em execução.
- referência de API do SDK do Aplicativo Windows para confirmar as opções de API geradas.
Windows developer