豆包如何自定义传输协议的

豆包如何自定义传输协议的

现象： 安装完豆包后，直接打开内置浏览器，协议
doubao://doubao-onboarding/

自定义浏览器协议（也称为自定义 URL 方案）允许你创建一个特定的 URL 格式，用户可以通过该格式在浏览器中启动特定的应用程序或执行特定的操作。以下是如何自定义浏览器协议（例如 doubao://doubao-onboarding/）的步骤。

1. 定义自定义协议

首先，你需要定义一个唯一的协议名称，例如 doubao。这个名称应该在你的应用程序中是唯一的，并且不应该与现有的协议冲突。

2. 注册自定义协议

注册自定义协议的方式取决于操作系统和浏览器。以下是针对不同操作系统的注册方法：

Windows

在 Windows 上，你可以通过注册表来注册自定义协议。

1. 打开注册表编辑器：

• 按 Win + R 打开运行对话框，输入 regedit，然后按回车。

2. 导航到注册表项：

• 导航到 HKEY_CLASSES_ROOT。

3. 创建新的协议项：

• 右键点击 HKEY_CLASSES_ROOT，选择 新建 -> 项，并命名为 doubao。

4. 设置默认值：

   • 右键点击 doubao 项，选择 新建 -> 字符串值，并命名为 (默认)。
   • 双击 (默认)，输入 URL:doubao Protocol。

5. 设置 URL 协议：

   • 右键点击 doubao 项，选择 新建 -> 字符串值，并命名为 URL Protocol。
   • 双击 URL Protocol，留空或输入 URL:doubao Protocol。

6. 创建 Shell 项：

   • 右键点击 doubao 项，选择 新建 -> 项，并命名为 shell。
   • 在 shell 项下，右键点击，选择 新建 -> 项，并命名为 open。
   • 在 open 项下，右键点击，选择 新建 -> 项，并命名为 command。

7. 设置命令：

   • 右键点击 command 项，选择 新建 -> 字符串值，并命名为 (默认)。

   • 双击 (默认)，输入你的应用程序路径和参数。例如：

     "C:\Path\To\Your\Application.exe" "%1"
     

     这里的 %1 代表传递给协议的 URL。
     

macOS

在 macOS 上，你可以通过创建一个 .plist 文件来注册自定义协议。

1. 创建 .plist 文件：

• 创建一个新的 .plist 文件，例如 com.yourcompany.doubao.plist。

2. 编辑 .plist 文件：

   • 使用文本编辑器打开 .plist 文件，并添加以下内容：

     <?xml version="1.0" encoding="UTF-8"?>
     <!DOCTYPE plist PUBLIC "-//Apple//DTD PLIST 1.0//EN" "http://www.apple.com/DTDs/PropertyList-1.0.dtd">
     <plist version="1.0">
     <dict>
         <key>CFBundleURLTypes</key>
         <array>
             <dict>
                 <key>CFBundleURLName</key>
                 <string>com.yourcompany.doubao</string>
                 <key>CFBundleURLSchemes</key>
                 <array>
                     <string>doubao</string>
                 </array>
             </dict>
         </array>
     </dict>
     </plist>
     

3. 安装 .plist 文件：

   • 将 .plist 文件复制到 ~/Library/LaunchAgents/ 目录下。
   • 重启系统或使用 launchctl load ~/Library/LaunchAgents/com.yourcompany.doubao.plist 加载配置。

4. 配置应用程序：

   • 确保你的应用程序能够处理传递的 URL。你可以在应用程序中使用 NSAppleEventManager 来接收 URL 事件。

Linux

在 Linux 上，注册自定义协议的方式取决于桌面环境。以下是一个通用的方法：

1. 创建 .desktop 文件：

• 创建一个新的 .desktop 文件，例如 doubao.desktop。

2. 编辑 .desktop 文件：

   • 使用文本编辑器打开 .desktop 文件，并添加以下内容：

     [Desktop Entry]
     Name=Doubao
     Exec=/path/to/your/application %u
     Icon=/path/to/icon.png
     Terminal=false
     Type=Application
     Categories=Network;
     MimeType=x-scheme-handler/doubao;
     

3. 安装 .desktop 文件：

   • 将 .desktop 文件复制到 ~/.local/share/applications/ 目录下。
   • 运行 update-desktop-database 命令更新桌面数据库。

4. 配置 MIME 类型：

   • 创建一个新的 MIME 类型文件，例如 doubao.xml。
   • 使用文本编辑器打开 doubao.xml 文件，并添加以下内容：

     <?xml version="1.0" encoding="UTF-8"?>
     <mime-info xmlns='http://www.freedesktop.org/standards/shared-mime-info'>
       <mime-type type="x-scheme-handler/doubao">
         <comment>Doubao Protocol</comment>
         <glob pattern="doubao:*"/>
       </mime-type>
     </mime-info>
     

5. 安装 MIME 类型：

   • 将 doubao.xml 文件复制到 ~/.local/share/mime/packages/ 目录下。
   • 运行 update-mime-database ~/.local/share/mime 命令更新 MIME 数据库。

3. 在应用程序中处理自定义协议

确保你的应用程序能够处理传递的 URL。以下是一些常见框架的处理方法：

Electron

如果你使用 Electron 开发应用程序，可以在 main.js 中处理自定义协议：

const { app, protocol } = require('electron');

app.on('ready', () => {
  protocol.registerFileProtocol('doubao', (request, callback) => {
    const url = request.url.replace('doubao://', '');
    // 处理 URL
    console.log(url);
    // 打开特定页面或执行特定操作
    // mainWindow.loadURL(`file://${__dirname}/index.html#${url}`);
  });
});

JavaFX

如果你使用 JavaFX 开发应用程序，可以在 main 方法中处理自定义协议：

import javafx.application.Application;
import javafx.stage.Stage;

public class MainApp extends Application {

    @Override
    public void start(Stage primaryStage) {
        // 处理自定义协议
        Parameters params = getParameters();
        List<String> rawArgs = params.getRaw();
        for (String arg : rawArgs) {
            if (arg.startsWith("doubao://")) {
                String url = arg.replace("doubao://", "");
                // 处理 URL
                System.out.println(url);
                // 打开特定页面或执行特定操作
            }
        }
        // 启动应用程序
        primaryStage.setTitle("Doubao");
        primaryStage.show();
    }

    public static void main(String[] args) {
        launch(args);
    }
}

4. 测试自定义协议

在注册和配置完成后，你可以通过以下方式测试自定义协议：

• 浏览器中输入 URL：

• 打开浏览器，输入 doubao://doubao-onboarding/，看看是否能够启动你的应用程序。

• HTML 链接：

  • 创建一个 HTML 文件，包含一个链接：

    <a href="doubao://doubao-onboarding/">Open Doubao</a>
    

  • 打开 HTML 文件，点击链接，看看是否能够启动你的应用程序。

5. 注意事项

• 安全性：确保自定义协议不会被恶意利用。不要在处理 URL 时执行不安全的操作。
• 兼容性：不同操作系统和浏览器对自定义协议的支持可能有所不同，确保在目标平台上进行充分测试。
• 用户体验：提供清晰的提示和说明，告知用户如何安装和使用自定义协议。

通过以上步骤，你可以在后台管理系统中自定义浏览器协议 doubao://doubao-onboarding/，并确保应用程序能够正确处理这些协议。