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

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

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


在 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,并实现跳转到指定页面的功能。如果有任何疑问或需要进一步的帮助,请随时补充说明!

相关推荐

Html中Css样式Ⅱ_html+css+

元素的定位(方式五种定位方式):静态定位:position:static;相对定位:position:relative;绝对定位:position:absolute;固定定位:position...

HTML 标签和属性值的基本格式_html标签及属性的语法规则

HTML:HyperTextMarkupLanguage超文本标记语言HTML代码不区分大小写,包括HTML标记、属性、属性值都不区分大小写;任何空格或回车键在代码中都无效,插入空格或回车有...

基于Visual Studio C#语言开发上位机,做定制设计后有多好看

...

C#中使用Halcon开发视觉检测程序教程

一、环境准备1.安装Halcon从Halcon官方网站下载适合你操作系统的安装包,按照安装向导完成安装。安装过程中,记住安装路径,后续配置环境时会用到。2.配置VisualStudio项目打开V...

【开源】C#功能强大,灵活的跨平台开发框架 - Uno Platform

前言今天给广大网友分享一个基于C#开源、功能强大、灵活的跨平台开发框架,她就是:UnoPlatform。通过UnoPlatform,开发者可以利用单一代码库实现多平台兼容,极大地提高了开发效率和...

C# 的发展简史_c#的发展前景

1.C#的诞生和初期(2000-2005)2000年:在微软的PDC大会上,由AndersHejlsberg首次公开展示了C#语言。2002年:微软发布了.NETFramework1.0,其...

Visual Studio 2010-C#跟西门子1200(Sharp7)窗体控制②-启动按钮

VisualStudio2010--C#跟西门子1200(Sharp7)窗体控制②--启动按钮上期回顾(上期主要是新建窗体应用程序,添加sharp7的类库并引用,建立一个button按钮):本期将...

Visual Studio窗口布局混乱后的恢复与优化指南

在使用VisualStudio进行开发时,我们常因误操作(如拖拽窗口、关闭面板、多显示器切换)导致界面布局混乱,代码编辑器、解决方案资源管理器、属性面板等组件“错位”,严重影响开发效率。本文将针对布...

使用Visual Studio 2017为AutoCAD创建一个c#模板

本教程的目标是展示如何在VisualStudio2017中创建AutoCAD的c#项目模板,该模板允许在调试模式下从VisualStudio加载DLL来自动启动AutoCAD。本文展示的示例使用...

IT科技-续3Visual Studio2019-C#实战练习

上次完成了登录页面的窗体设计,本次完成管理界面的设计。第一步ComBox控制深度操作点击编辑选项,加入预定选项,完成操作。第二步复制Buttons控件依次为保存、删除、重置、编辑按钮属性设置,参考...

如何在 C# 中将文本转换为 Word 以及将 Word 转换为文本

在现代软件开发中,处理文档内容是一个非常常见的需求。无论是生成报告、存储日志,还是处理用户输入,开发者都可能需要在纯文本与Word文档之间进行转换。有时需要将文本转换为Word,以便生成结构化的...

简短的C#入门教程 # C# 入门教程 C#(读作...

简短的C#入门教程#C#入门教程C#(读作CSharp)是一种由Microsoft开发的多范式编程语言,它具有广泛的应用,特别是在Windows平台上。本教程将介绍C#的基础知识,以帮助您入门这...

JavaScript中this指向各种场景_前端中this的指向

在JavaScript中,this的指向是一个核心概念,其值取决于函数的调用方式,而非定义位置(箭头函数除外)。以下是this指向的常见场景及具体说明:1.全局作用域中的this在全局作用域(非...

微信WeUI设计规范文件下载及使用方法

来人人都是产品经理【起点学院】,BAT实战派产品总监手把手系统带你学产品、学运营。WeUI是一套同微信原生视觉体验一致的基础样式库,由微信官方设计团队为微信Web开发量身设计,可以令用户的使用感知...

JavaScript技术:如何动态添加事件?

随着前端技术的不断发展,JavaScript已经成为了不可或缺的一部分,它可以让网页变得更加流畅和美观。但是,在JavaScript中动态添加事件还是一个比较困难的问题,为此,本文将从入门到精通,介绍...