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

Abierto
#27 0 comentarios 0 reacciones 0 asignados Ver en GitHub

Nadie ha tomado este issue todavía.

Evaluación

Dificultad
5/5
Tiempo estimado
Más de una semana
Aptitud para principiantes
35/100
Tipo de issue
Nueva funcionalidad
Claridad
Bien especificado
Estado de actividad
Activo
Stack tecnológico
dart, flutter, typescript
Área
api, desktop

Línea de trabajo

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.

Escrito por el modelo de indexación a partir del texto del issue.

Descripción

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
Lenguaje dominante
TypeScript
Estrellas
172
Forks
16
Merge medio
40 min
PR fusionados (30 d)
2

Preparar el entorno

Este proyecto no incluye contenedor de desarrollo, Dockerfile ni guía de contribución, así que la configuración corre por tu cuenta: empieza por su README y consulta nuestra guía para la primera contribución para los pasos generales.

Primeros pasos

  1. Lee el issue completo y luego la guía de contribución del proyecto.
  2. Comenta en el issue que vas a ocuparte — evita que dos personas hagan lo mismo.
  3. Haz un fork del repositorio y trabaja en una rama.
  4. Abre un pull request que haga referencia al número del issue.

Más de libnativeapi/nativeapi

Todos los issues de libnativeapi/nativeapi

Issues similares

Más issues de TypeScript

Recibe los nuevos issues en tu correo

Un resumen breve de issues de GitHub para principiantes.