百度360必应搜狗淘宝本站头条
当前位置:网站首页 > IT知识 > 正文

react native中自定义 URL Scheme并跳转到指定页面

liuian 2025-05-03 15:17 23 浏览


在 React Native 中实现类似 Android 的自定义 URL Scheme(
myapp://open)并跳转到指定页面,可以通过以下步骤完成。React Native 提供了对深度链接(Deep Linking)的支持,可以让你通过 URI 打开应用并导航到特定页面。

以下是详细的配置和使用方法:


1. 配置自定义 URL Scheme

(1) 在 Android 中配置

React Native 应用的 Android 部分需要在 AndroidManifest.xml 文件中注册自定义的 URL Scheme。

打开
android/app/src/main/AndroidManifest.xml
,在 <activity> 标签中添加以下内容:

<activity
    android:name=".MainActivity"
    android:launchMode="singleTask">
    <intent-filter>
        <!-- 定义 Action -->
        <action android:name="android.intent.action.VIEW" />

        <!-- 定义 Category -->
        <category android:name="android.intent.category.DEFAULT" />
        <category android:name="android.intent.category.BROWSABLE" />

        <!-- 定义自定义的 Scheme 和 Host -->
        <data
            android:scheme="myapp"
            android:host="open" />
    </intent-filter>
</activity>

说明:

  • android:scheme="myapp":定义了自定义的 Scheme。
  • android:host="open":定义了自定义的 Host。
  • 结合起来,完整的 URI 格式为 myapp://open

(2) 在 iOS 中配置

对于 iOS,需要在 Info.plist 文件中注册 URL Scheme。

打开
ios/YourProjectName/Info.plist
,添加以下内容:

<key>CFBundleURLTypes</key>
<array>
    <dict>
        <key>CFBundleURLSchemes</key>
        <array>
            <string>myapp</string>
        </array>
        <key>CFBundleURLName</key>
        <string>com.yourcompany.myapp</string>
    </dict>
</array>

说明:

  • CFBundleURLSchemes:定义了自定义的 Scheme(如 myapp)。
  • CFBundleURLName:可以是你的应用的 Bundle ID 或其他唯一标识符。

2. 在 React Native 中处理 Deep Link

React Native 提供了 Linking 模块来处理深度链接。你需要监听传入的 URI,并根据 URI 的内容导航到指定页面。

(1) 监听 Deep Link

在你的主组件(如 App.js)中,使用 Linking 模块监听传入的 URI:

import React, { useEffect } from 'react';
import { Linking, Text, View } from 'react-native';

const App = () => {
  useEffect(() => {
    // 处理启动时的初始 URI
    const handleInitialUrl = async () => {
      const initialUrl = await Linking.getInitialURL();
      if (initialUrl) {
        handleDeepLink(initialUrl);
      }
    };

    handleInitialUrl();

    // 监听后续的 URI 变化
    const linkingSubscription = Linking.addEventListener('url', (event) => {
      handleDeepLink(event.url);
    });

    return () => {
      // 清理事件监听
      linkingSubscription.remove();
    };
  }, []);

  const handleDeepLink = (url) => {
    console.log('Received URL:', url);

    // 解析 URL 并跳转到指定页面
    if (url.startsWith('myapp://open')) {
      // 跳转到指定页面,例如:
      console.log('Navigating to the target page...');
      // 使用你的导航库(如 React Navigation)进行页面跳转
    }
  };

  return (
    <View>
      <Text>React Native Deep Link Example</Text>
    </View>
  );
};

export default App;

说明:

  • Linking.getInitialURL():获取应用启动时的初始 URI。
  • Linking.addEventListener('url', callback):监听后续的 URI 变化。
  • handleDeepLink(url):解析 URI 并执行相应的逻辑。

(2) 使用 React Navigation 进行页面跳转

如果你使用的是 react-navigation,可以在 handleDeepLink 函数中调用导航方法。例如:

import { NavigationContainer } from '@react-navigation/native';
import { createStackNavigator } from '@react-navigation/stack';

const Stack = createStackNavigator();

const App = () => {
  const [initialRoute, setInitialRoute] = React.useState('Home');

  useEffect(() => {
    const handleInitialUrl = async () => {
      const initialUrl = await Linking.getInitialURL();
      if (initialUrl) {
        handleDeepLink(initialUrl);
      }
    };

    handleInitialUrl();

    const linkingSubscription = Linking.addEventListener('url', (event) => {
      handleDeepLink(event.url);
    });

    return () => linkingSubscription.remove();
  }, []);

  const handleDeepLink = (url) => {
    if (url.startsWith('myapp://open')) {
      // 设置初始路由为目标页面
      setInitialRoute('TargetPage');
    }
  };

  return (
    <NavigationContainer>
      <Stack.Navigator initialRouteName={initialRoute}>
        <Stack.Screen name="Home" component={HomeScreen} />
        <Stack.Screen name="TargetPage" component={TargetPage} />
      </Stack.Navigator>
    </NavigationContainer>
  );
};

3. 测试 Deep Link

(1) 在 Android 上测试

  • 使用 ADB 命令模拟点击 URI:
  • adb shell am start -W -a android.intent.action.VIEW -d "myapp://open" com.yourcompany.myapp

(2) 在 iOS 上测试

  • 使用 Xcode 模拟器运行应用后,在终端执行以下命令:
  • xcrun simctl openurl booted "myapp://open"

(3) 在浏览器中测试

  • 在手机浏览器中输入 myapp://open,观察是否能唤起应用。

4. 注意事项

(1) 参数传递

你可以在 URI 中传递参数,例如:

  • myapp://open?screen=profile&id=123
  • handleDeepLink 中解析参数:
  • const params = new URLSearchParams(url.split('?')[1]);
    const screen = params.get('screen'); // profile
    const id = params.get('id'); // 123

(2) 安全性

  • 验证传入的 URI 是否合法,避免恶意调用。
  • 如果涉及敏感操作,建议结合签名验证或 Token 校验。

(3) Universal Links(推荐)

  • 对于更安全和可靠的深度链接,建议使用 Universal Links(iOS)和 App Links(Android),它们基于 HTTPS 协议,避免了自定义 Scheme 的潜在冲突问题。

通过以上步骤,你可以成功在 React Native 中配置和使用自定义 URL Scheme,并实现跳转到指定页面的功能。如果有任何疑问或需要进一步的帮助,请随时补充说明!

相关推荐

Optional是个好东西,如果用错了就太可惜了

原文出处:https://xie.infoq.cn/article/e3d1f0f4f095397c44812a5be我们都知道,在Java8新增了一个类-Optional,主要是用来解决程...

IDEA建议:不要在字段上使用@Autowire了!

在使用IDEA写Spring相关的项目的时候,在字段上使用@Autowired注解时,总是会有一个波浪线提示:Fieldinjectionisnotrecommended.纳尼?我天天用,咋...

Spring源码|Spring实例Bean的方法

Spring实例Bean的方法,在AbstractAutowireCapableBeanFactory中的protectedBeanWrappercreateBeanInstance(String...

Spring技巧:深入研究Java 14和SpringBoot

在本期文章中,我们将介绍Java14中的新特性及其在构建基于SpringBoot的应用程序中的应用。开始,我们需要使用Java的最新版本,也是最棒的版本,Java14,它现在还没有发布。预计将于2...

Java开发200+个学习知识路线-史上最全(框架篇)

1.Spring框架深入SpringIOC容器:BeanFactory与ApplicationContextBean生命周期:实例化、属性填充、初始化、销毁依赖注入方式:构造器注入、Setter注...

年末将至,Java 开发者必须了解的 15 个Java 顶级开源项目

专注于Java领域优质技术,欢迎关注作者:SnailClimbStar的数量统计于2019-12-29。1.JavaGuideGuide哥大三开始维护的,目前算是纯Java类型项目中Sta...

字节跨平台框架 Lynx 开源:一个 Web 开发者的原生体验

最近各大厂都在开源自己的跨平台框架,前脚腾讯刚宣布计划四月开源基于Kotlin的跨平台框架「Kuikly」,后脚字节跳动旧开源了他们的跨平台框架「Lynx」,如果说Kuikly是一个面向...

我要狠狠的反驳“公司禁止使用Lombok”的观点

经常在其它各个地方在说公司禁止使用Lombok,我一直不明白为什么不让用,今天看到一篇文章列举了一下“缺点”,这里我只想狠狠地反驳,看到列举的理由我竟无言以对。原文如下:下面,结合我自己使用Lomb...

SpringBoot Lombok使用详解:从入门到精通(注解最全)

一、Lombok概述与基础使用1.1Lombok是什么Lombok是一个Java库,它通过注解的方式自动生成Java代码(如getter、setter、toString等),从而减少样板代码的编写,...

Java 8之后的那些新特性(六):记录类 Record Class

Java是一门面向对象的语言,而对于面向对象的语言中,一个众所周知的概念就是,对象是包含属性与行为的。比如HR系统中都会有雇员的概念,那雇员会有姓名,ID身份,性别等,这些我们称之为属性;而雇员同时肯...

为什么大厂要求安卓开发者掌握Kotlin和Jetpack?优雅草卓伊凡

为什么大厂要求安卓开发者掌握Kotlin和Jetpack?深度解析现代Android开发生态优雅草卓伊凡一、Kotlin:Android开发的现代语言选择1.1Kotlin是什么?Kotlin是由...

Kotlin这5招太绝了!码农秒变优雅艺术家!

Kotlin因其简洁性、空安全性和与Java的无缝互操作性而备受喜爱。虽然许多开发者熟悉协程、扩展函数和数据类等特性,但还有一些鲜为人知的特性可以让你的代码从仅仅能用变得真正优雅且异常简洁。让我们来看...

自行部署一款免费高颜值的IT资产管理系统-咖啡壶chemex

在运维时,ICT资产太多怎么办,还是用excel表格来管理?效率太低,也不好多人使用。在几个IT资产管理系统中选择比较中,最终在Snipe-IT和chemex间选择了chemex咖啡壶。Snip...

PHP对接百度语音识别技术(php对接百度语音识别技术实验报告)

引言在目前的各种应用场景中,语音识别技术已经越来越常用,并且其应用场景正在不断扩大。百度提供的语音识别服务允许用户通过简单的接口调用,将语音内容转换为文本。本文将通过PHP语言集成百度的语音识别服务,...

知识付费系统功能全解析(知识付费项目怎么样)

开发知识付费系统需包含核心功能模块,确保内容变现、用户体验及运营管理需求。以下是完整功能架构:一、用户端功能注册登录:手机号/邮箱注册,第三方登录(微信、QQ)内容浏览:分类展示课程、文章、音频等付费...