URL Protocol

Posted on Edited on Views: Changyan:

为指定程序注册URL Protocol,方便浏览器调用[^1]

<scheme>://<host>:<port>[<path>|<pathPrefix>|<pathPattern>|<pathAdvancedPattern>|<pathSuffix>]

1. Windows

C#

1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
/// <summary>
/// 为指定程序注册URL Protocol,方便浏览器调用
/// </summary>
/// <param name="ProtocolName">协议名称</param>
/// <param name="path">程序的完整路径</param>
/// <param name="Exists">写入前存在状态</param>
/// <param name="Override">如果存在是否重写数据，默认 false 不重写</param>
/// <exception cref="ArgumentException">参数异常</exception>
public static void RegisterUrlProtocol(string ProtocolName, string path, out bool Exists, bool Override = false)
{
    if (string.IsNullOrWhiteSpace(ProtocolName))
    {
        throw new ArgumentException("协议名称为空！！！");
    }

    Microsoft.Win32.RegistryKey key = Microsoft.Win32.Registry.ClassesRoot.OpenSubKey(ProtocolName, true);
    Exists = key != null;
    if (Exists && !Override)
    {
        return;
    }
    if (string.IsNullOrWhiteSpace(path))
    {
        throw new ArgumentException("关联程序路径为空！！！");
    }

    if (!File.Exists(path))
    {
        throw new ArgumentException("关联程序不存在！！！");
    }
    key = key ?? Microsoft.Win32.Registry.ClassesRoot.CreateSubKey(ProtocolName);
    key.SetValue("", $"{ProtocolName} Protocol", Microsoft.Win32.RegistryValueKind.String);
    key.SetValue("URL Protocol", path, Microsoft.Win32.RegistryValueKind.String);
    key.CreateSubKey("DefaultIcon").SetValue("", $"{path},1", Microsoft.Win32.RegistryValueKind.String);
    key.CreateSubKey("shell").CreateSubKey("open").CreateSubKey("command")
        .SetValue("", $"\"{path}\" \"%1\"", Microsoft.Win32.RegistryValueKind.String);
}

2. Android [^2]

AndroidManifest.xml 

1
2
3
4
5
6
7
8
9
<activity>
    <intent-filter>
        <action android:name="android.intent.action.VIEW">
        <category android:name="android.intent.category.DEFAULT">
        <category android:name="android.intent.category.BROWSABLE" /> 
        <!-- Accepts URIs that begin with "example://gizmos” -->  
        <data android:scheme="example" android:host="gizmos" />
    </intent-filter>  
</activity>

Activity.kt 

1
2
3
4
5
6
override fun onCreate(savedInstanceState: Bundle?) {
    super.onCreate(savedInstanceState)
    setContentView(R.layout.main)
    val action: String? = intent?.action
    val data: Uri? = intent?.data  
}

[^1] https://www.ietf.org/rfc/rfc2396.txt https://developer.android.google.cn/guide/topics/manifest/data-element?hl=zh-cn#scheme [^2] https://developer.android.google.cn/training/app-links/deep-linking?hl=zh-cn https://developer.android.google.cn/reference/java/net/URI?hl=en https://developer.android.google.cn/codelabs/android-app-links-introduction?hl=zh-cn#0 https://developer.android.google.cn/training/app-links?hl=zh-cn https://www.python100.com/html/110711.html