#接入 Lynx DevTool

#引入依赖

你需要新增以下组件：LynxService 的 Devtool 子组件、 LynxDevTool 和 DebugRouter。 请确保 Podfile 已按 Lynx 集成指南 声明 lynx-family Specs 仓库作为源。

target 'YourTarget' do
  pod 'LynxService', '4.1.0', :subspecs => [
      'Devtool',
  ]
  pod 'LynxDevtool', '4.1.0'

  pod 'DebugRouter', '5.0.15'
  pod 'DebugRouter/MessageTransceiverEnable', '5.0.15'
end

#打开 DevTool

DevTool 提供了一些调试功能开关， 其中有几个比较重要的开关：

• Lynx DevTool 控制 DevTool 的基础调试功能：元件审查和 JavaScript 调试。
• Lynx LogBox 控制 LogBox 功能。

你可以在初始化 LynxEnv 时打开设置这些开关：

#import <Lynx/LynxEnv.h>

@implementation AppDelegate

- (BOOL)application:(UIApplication *)application didFinishLaunchingWithOptions:(NSDictionary *)launchOptions {
  // ...
  // 准备 DevTool
  [LynxEnv prepareDevToolForDevelopmentBeforeInit];
  LynxEnv *lynxEnv = [LynxEnv sharedInstance];
  // 打开 Lynx DevTool 开关
  lynxEnv.devtoolEnabled = YES;
  // 打开 Lynx LogBox 开关
  lynxEnv.logBoxEnabled = YES;
  return YES;
}

#import <Lynx/LynxEnv.h>

class AppDelegate: UIResponder, UIApplicationDelegate {

  func application(_ application: UIApplication, didFinishLaunchingWithOptions launchOptions: [UIApplication.LaunchOptionsKey: Any]?) -> Bool {
    // ...
    // 准备 DevTool
    LynxEnv.prepareDevToolForDevelopmentBeforeInit()
    let lynxEnv = LynxEnv.sharedInstance()
    // 打开 Lynx DevTool 开关
    lynxEnv.devtoolEnabled = true
    // 打开 Lynx LogBox 开关
    lynxEnv.logBoxEnabled = true
    return true
  }
}

#引入依赖

你需要接入这两个组件：lynx-service-devtool 和 lynx-devtool

// Lynx DevTool 接入时请保证和 Lynx 相同版本
dependencies {
  implementation "org.lynxsdk.lynx:lynx-devtool:4.1.0"
  implementation "org.lynxsdk.lynx:lynx-service-devtool:4.1.0"
}

// Lynx DevTool 接入时请保证和 Lynx 相同版本
dependencies {
  implementation ("org.lynxsdk.lynx:lynx-devtool:4.1.0")
  implementation ("org.lynxsdk.lynx:lynx-service-devtool:4.1.0")
}

#注册 DevTool Service

DevTool Service 提供了一些启动配置值，以控制默认行为，可以根据实际需求进行配置。下面的示例会为尚未设置的配置值应用开发环境下的默认值。

private void initLynxService() {
  // ...
  // register DevTool service
  LynxServiceCenter.inst().registerService(LynxDevToolService.getINSTANCE());
  // 准备 DevTool
  LynxEnv.inst().prepareDevToolForDevelopmentBeforeInit();
}

private fun initLynxService() {
  // ...
  // register DevTool service
  LynxServiceCenter.inst().registerService(LynxDevToolService.INSTANCE)
  // 准备 DevTool
  LynxEnv.inst().prepareDevToolForDevelopmentBeforeInit()
}

#打开 DevTool

DevTool 提供了一些调试功能开关， 其中有几个比较重要的开关：

• Lynx DevTool 控制 DevTool 的基础调试功能：元件审查和 JavaScript 调试。
• Lynx LogBox 控制 LogBox 功能。

你可以在初始化 LynxEnv 时打开设置这些开关：

private void initLynxEnv() {
  LynxEnv.inst().init(this, null, null, null);
  // 将 DevTool 推进至 ENABLED 状态
  LynxEnv.inst().enableLynxDebug(true);
  // 打开 Lynx DevTool 开关
  LynxEnv.inst().enableDevtool(true);
  // 打开 Lynx LogBox 开关
  LynxEnv.inst().enableLogBox(true);
}

private fun initLynxEnv() {
  LynxEnv.inst().init(this, null, null, null)
  // 将 DevTool 推进至 ENABLED 状态
  LynxEnv.inst().enableLynxDebug(true)
  // 打开 Lynx DevTool 开关
  LynxEnv.inst().enableDevtool(true)
  // 打开 Lynx LogBox 开关
  LynxEnv.inst().enableLogBox(true)
}

#引入依赖

你需要接入这两个组件：@lynx/lynx_devtool 和 @lynx/lynx_devtool_service。

// Lynx DevTool 接入时请保证和 Lynx 相同版本
"dependencies": {
  "@lynx/lynx_devtool": "@param:dependencies.lynx_version",
  "@lynx/lynx_devtool_service": "@param:dependencies.lynx_version"
}

// 由于 `@lynx/lynx_devtool` 是通过变量动态 import，为了将 devtool 模块加入编译，
// 还需要额外在 build-profile.json5 中的 buildOption 额外增加一个 runtimeOnly 的 buildOption 配置。
"buildOption": {
    "arkOptions": {
      "runtimeOnly": {
        "packages": [
          "@lynx/lynx_devtool"
        ]
      }
    },
}

#注册 DevTool Service

// Initialize LynxDevToolService first, as LynxEnv initialization
// depends on LynxDevToolService from LynxService
LynxServiceCenter.registerService(
  LynxServiceType.DevTool,
  LynxDevToolService.instance,
);

#打开 DevTool

DevTool 提供了一些调试功能开关， 其中有几个比较重要的开关：

• Lynx DevTool 控制 DevTool 的基础调试功能：元件审查和 JavaScript 调试。
• Lynx LogBox 控制 LogBox 功能。

你可以在初始化 LynxEnv 时打开设置这些开关：

public initLynxEnv() {
  LynxEnv.initialize(this.context);

  // 将 DevTool 推进至 ENABLED 状态
  LynxEnv.enableLynxDebug(true);
  // 打开 Lynx DevTool 开关
  LynxEnv.enableDevtool(true);
  // 打开 Lynx LogBox 开关
  LynxEnv.setLogBoxEnabled(true);
}