NativeScript URL 处理器插件

请随意 捐赠

或捐赠比特币：bitcoin:3NKtxw1SRYgess5ev4Ri54GekoAgkR213D

也可以通过 greenaddress

使用方法

只需将应用链接添加到您的应用中，查看下面的 iOS 和 Android 指令，并注册 URL 数据的处理程序。

请参考以下 Angular 示例

import { Component, OnInit } from "@angular/core";
import { handleOpenURL, AppURL } from 'nativescript-urlhandler';

@Component({
  selector: "gr-main",
  template: "<page-router-outlet></page-router-outlet>"
})
export class AppComponent {
    constructor() {
    } 
    
    ngOnInit(){
        handleOpenURL((appURL: AppURL) => {
            console.log('Got the following appURL', appURL);
        });
     }
}

以及纯 NativeScript

var handleOpenURL = require("nativescript-urlhandler").handleOpenURL;

handleOpenURL(function(appURL) {
  console.log('Got the following appURL', appURL);
});

或者作为 TypeScript

import { handleOpenURL, AppURL } from 'nativescript-urlhandler';

handleOpenURL((appURL: AppURL) => {
  console.log('Got the following appURL', appURL);
});

注意：请查看 demo 应用以获取示例用法。首先在应用主文件中添加 handleOpenURL!

安装

$ tns plugin add nativescript-urlhandler

或者如果您想使用开发版本（夜间构建），这可能不够稳定！

$ tns plugin add nativescript-urlhandler@next

Android

将 myapp 替换为您希望使用的方案，并将启动模式设置为 singleTask

<activity android:name="com.tns.NativeScriptActivity" ... android:launchMode="singleTask"...>
        ...
    <intent-filter>
    <data android:scheme="myapp" /> 
    <action android:name="android.intent.action.VIEW" /> 
    <category android:name="android.intent.category.DEFAULT" /> 
    <category android:name="android.intent.category.BROWSABLE" /> 
    </intent-filter>

例如

<activity android:name="com.tns.NativeScriptApplication" android:label="@string/app_name" android:launchMode="singleTask">
  <intent-filter>
      <action android:name="android.intent.action.MAIN" />
      <category android:name="android.intent.category.LAUNCHER" />
  </intent-filter>
  <intent-filter>
      <action android:name="android.intent.action.VIEW" />
      <category android:name="android.intent.category.DEFAULT" />
      <category android:name="android.intent.category.BROWSABLE" /> 
      <data android:scheme="myapp" android:host="__PACKAGE__" />
  </intent-filter>
</activity>

android:launchMode="singleTask" 告诉 Android 操作系统使用活动的新实例启动应用，或者使用现有的一个。没有这个，您的应用将启动多个实例，这是不可取的。

iOS

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

常见问题解答

回调处理

"handleOpenURL" 回调必须在应用程序初始化之前调用，否则您将在控制台看到此错误

    No callback provided. Please ensure that you called "handleOpenURL" during application init!

Webpack

TypeScript 配置

如果您的 Webpack 构建失败，请尝试调整您的 tsconfig 以匹配此配置

    "compilerOptions": {
        "module": "commonjs",
        "target": "es5",
        "experimentalDecorators": true,
        "emitDecoratorMetadata": true,
        "noEmitHelpers": true,
        "noEmitOnError": true,
        "lib": [
            "es6",
            "dom",
            "es2015.iterable"
        ],
        "baseUrl": ".",
        "paths": {
            "*": [
                "./node_modules/tns-core-modules/*",
                "./node_modules/*"
            ]
        }
    },
    "exclude": [
        "node_modules",
        "platforms",
        "**/*.aot.ts"
    ]