Migrate protocol_handler's custom protocol and deep-link capabilities to NativeAPI

Aberta
  • Algo errado?
#27 0 comentários 0 reações 0 responsáveis Ver no GitHub

Ninguém assumiu esta issue ainda.

Avaliação

Dificuldade
5/5
Tempo estimado
Mais de uma semana
Facilidade para iniciantes
35/100
Tipo de issue
Funcionalidade
Clareza
Claramente especificada
Status de atividade
Ativa
Stack de tecnologia
dart, flutter, typescript
Domínio
api, desktop

Direção de pesquisa

Start with the linked protocol_handler README and public API references to map the existing registration, launch URL, event, and listener behavior. Then inspect NativeAPI's UrlOpener and its Dart/Flutter bindings and platform integrations. Done means equivalent APIs, setup documentation and a migration example cover Android, iOS, macOS, and Windows, with the listed scenarios validated on each.

Escrita pelo modelo de indexação a partir do texto da issue.

Descrição

Goal

Bring the full public capability set of protocol_handler into NativeAPI so Flutter apps can migrate without losing functionality.

Scope

Provide equivalents for:

  • register(String scheme) for custom protocol registration/configuration.
  • getInitialUrl() for retrieving the URL that launched the app.
  • onUrlReceived for incoming URL events.
  • ProtocolListener.onProtocolUrlReceived(String url), listener attachment/removal, and listeners / hasListeners inspection.

API names may change, but the migration guide should map every existing public capability to its NativeAPI equivalent.

Platform coverage

Match the source plugin's documented support: Android, iOS, macOS and Windows. Document the required Android intent filters, iOS/macOS URL scheme declarations, Windows runner integration and MSIX protocol activation configuration.

Acceptance criteria
  • Expose equivalent APIs to Dart/Flutter.
  • Document platform support, setup requirements and limitations.
  • Provide a migration guide and example covering registration, launch URLs, incoming events and listener cleanup.
  • Validate these scenarios on all four source-supported platforms.
Notes

NativeAPI's existing UrlOpener handles outbound URLs, not incoming protocol activations. The source plugin exposes no unregister API, so unregistration is not assumed to be part of migration parity. Linux support and other language bindings can be scoped separately.

References
Linguagem predominante
TypeScript
Estrelas
172
Forks
16
Merge médio
40min
PRs com merge (30d)
2

Preparar o ambiente

Este projeto não oferece contêiner de desenvolvimento, Dockerfile nem guia de contribuição, então a configuração fica por sua conta: comece pelo README e veja nosso guia da primeira contribuição para os passos gerais.

Primeiros passos

  1. Leia a issue inteira e depois o guia de contribuição do projeto.
  2. Comente na issue dizendo que vai assumir — evita que duas pessoas façam o mesmo trabalho.
  3. Faça um fork do repositório e trabalhe em uma branch.
  4. Abra um pull request que referencie o número da issue.

Mais de libnativeapi/nativeapi

Todas as issues de libnativeapi/nativeapi

Issues semelhantes

Mais issues de TypeScript

Receba novas issues na sua caixa de entrada

Um resumo curto de issues do GitHub para quem está começando.