react-navigation / react-navigation/react-navigation.github.io

Is deep linking documentation for ios wrong with regards to the scheme and identifier?

Abierto
#1,148 0 comentarios 0 reacciones 0 asignados Ver en GitHub

Nadie ha tomado este issue todavía.

Lenguaje dominante
JavaScript
Estrellas
324
Forks
2k
Métricas de merge de PR
Sin PR fusionados en 30 d

Descripción

initially posted here: https://github.com/react-navigation/react-navigation/discussions/10462
but got no response, and i feel like this is important.


under the docs for deep linking on ios: https://reactnavigation.org/docs/deep-linking/#setup-on-ios

there is a section for setting the scheme in the project.

here it says you can run a command to do it automatically:

npx uri-scheme add mychat --ios

this does indeed add mychat as a "URL Scheme" in Xcode. however, it does not add an "Identifier". that is left blank.

then underneath, there are instructions on how to do it manually instead of automatically.

here it shows that we need to add mychat for both "Identifier" and "URL Scheme". this is different than the previous method, now "Identifier" is no longer left blank.

i found the apple docs for deep linking: https://developer.apple.com/documentation/xcode/defining-a-custom-url-scheme-for-your-app

and here it says:

The identifier you supply with your scheme distinguishes your app from others that declare support for the same scheme. To ensure uniqueness, specify a reverse DNS string that incorporates your company’s domain and app name.

their example also shows that the "Identifier" is com.example.myphotoapp while the "URL Scheme" is myphotoapp.

so this makes me believe that the react-navigation documentation shouldt say we should set same string for both. it should show an example similar to the example from Apple.

now since every app already has a bundleId which is a reverse DNS string, that one should be used.

Guía de contribución

No hay ninguna guía de contribución indexada para este repositorio

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.

Línea de trabajo

Comienza en la sección “Setup on iOS” de la documentación sobre deep linking y compara el comando npx uri-scheme con las instrucciones manuales de Xcode. Comprueba las indicaciones de Apple sobre esquemas de URL personalizados enlazadas en el issue, incluida la distinción entre Identifier y URL Scheme. Se considera terminado cuando la documentación explica de forma coherente los valores correctos y refleja la configuración verificada.

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

Evaluación

Stack tecnológico
ios, react-native
Área
documentation, mobile
Tipo de issue
Documentación
Dificultad
2/5
Tiempo estimado
1-3 horas
Estado de actividad
Estancado
Claridad
Bien especificado
Aptitud para principiantes
52/100

Recibe los nuevos issues en tu correo

Un resumen breve de issues de GitHub para principiantes.