unoplatform/uno

[Docs] Mapping (Xamarin.Essentials)/.NET MAUI Platform APIs to WinRT APIs

Open

#16.665 aberto em 9 de mai. de 2024

Ver no GitHub
 (3 comments) (0 reactions) (0 assignees)C# (837 forks)batch import
difficulty/starter 🚀good first issuekind/documentation

Métricas do repositório

Stars
 (9.789 stars)
Métricas de merge de PR
 (Mesclagem média 14d 8h) (130 fundiu PRs em 30d)

Description

Description

The .NET MAUI documentation currently includes information on Platform APIs, which were formerly known as Essentials. https://learn.microsoft.com/en-us/dotnet/maui/platform-integration/?view=net-maui-8.0 To aid developers transitioning from (Xamarin.Essentials)/.NET MAUI Platform APIs to WinRT APIs, a comprehensive guide is essential. This guide should detail the API mappings, supported platforms, and necessary setup, and include practical usage examples.

Proposed content for this guide

  1. API Mapping Guide

    • Develop a detailed correspondence table or list mapping each (Xamarin.Essentials)/.NET MAUI Platform APIs to the WinRT APIs counterpart.
    • Highlight differences in API functionality or any limitations.

  2. Platform Support

    • Document the supported platforms for each of those.
    • Note any platforms that are no longer supported or have known issues as needed.

  3. Setup Instructions

    • Provide detailed setup instructions for each platform to assist developers in transitioning their projects.

  4. Usage Examples

    • Include samples & code examples showing how to utilize WinRT APIs to replace (Xamarin.Essentials)/.NET MAUI Platform functionalities.
    • Focus on common use cases previously handled by (Xamarin.Essentials)/.NET MAUI Platform functionalities.

cc @dansiegel, @jeromelaban

Guia do colaborador

Direção de pesquisa
Estude os mapeamentos de API entre as APIs da plataforma Xamarin.Essentials/.NET MAUI e as APIs WinRT. Crie uma tabela de correspondência detalhada, documente as plataformas suportadas e diferenças, forneça instruções de configuração e exemplos de código para casos de uso comuns.
Pilha de tecnologia
csharp
Domain
documentationapi
Tipo Issue
Documentação
DifficultyDificuldade de implementação estimada para um novo contribuidor, de 1 para alterações muito pequenas a 5 para trabalho de nível especializado.
3
Tempo estimadoUm intervalo de tempo aproximado para um colaborador experiente investigar, implementar, testar e preparar um pull request.
1-2 dias
Status da atividadeQuão disponível o issue aparece agora: novo, ativo, obsoleto, bloqueado ou aguardando entrada do mantenedor.
Ativo
ClarityCom que clareza o issue explica a mudança esperada, os critérios de aceitação e a próxima etapa.
Claro
Prerequisites
C#.NET MAUIWinRT
Simpatia para novatosUma pontuação de 1 a 100 que estima o quão acessível este issue é para colaboradores iniciantes.
55