NativeScript URL 处理插件

这是由 nativescript-urlhandler 的 Martin Reinhardt 直接分叉/重写的，该插件似乎已经不再维护，并且不符合预期

用法

只需将应用链接添加到您的应用中，请参阅以下 iOS 和 Android 说明，并为 URL 数据注册一个处理程序。

请参阅以下 Angular 示例

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

@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-appurl").handleOpenURL;

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

或者作为 TypeScript

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

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

注意：请参阅 demo 应用示例用法。从在应用主文件中添加 handleOpenURL 开始！

安装

$ tns plugin add nativescript-appurl

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

$ tns plugin add nativescript-appurl@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/@nativescript/core/*",
                "./node_modules/*"
            ]
        }
    },
    "exclude": [
        "node_modules",
        "platforms",
        "**/*.aot.ts"
    ]