Xray 是一个用于分析和调试移动端应用的问题工具，特别适用于处理与网络请求、UI 更新等相关的问题。以下是使用 Xray 的基本指南

安装 Xray

• 下载 Xray：
  • 如果是 Windows 用户，可以从 Xray 官方网站 下载安装包。
  • 如果是 macOS 用户，可以通过 Homebrew 包管理工具安装：

    brew install xray

• 安装完成后，在你的开发环境中设置 Xray 代理。

启动 Xray

• 打开终端或命令提示符,进入 Xray 的安装目录。

  cd /path/to/xray

• 运行 Xray：

  ./xray

• Xray 会自动启动，并在你的命令行中显示一个提示符，提示你输入命令。

设置 Xray 代理

• 在你的开发环境中,配置 Xray 作为 HTTP 代理。
  • Windows：

    # xray.conf
    proxy = "http://localhost:线路号"

  • macOS/Linux：

    export HTTP_PROXY=http://localhost:线路号

  • Android： 在 Android Studio 中，打开 工具 > Android > 调试，在 更改为开发模式 中选择 Xray 作为 HTTP代理。

配置项目

• 在你的项目中,将所有的网络请求和 UI 更新请求导向 Xray。
  • Android：

    // 在 AndroidManifest.xml 中添加
    <uses-permission android:name="android.permission.INTERNET" />
    // 在代码中添加代理
    OkHttpClient client = new OkHttpClient();
    client.proxy = new Proxy(Proxy.Type.HTTP, "http://localhost:线路号");
    Request request = new Request.Builder()
        .proxy(client)
        .get("https://example.com")
        .build();
    client.newCall(request).enqueue(new Callback(...) {
        @Override
        public void onFailure(Response response) {
            // 处理失败情况
        }
    });

  • iOS： 在项目中配置 HTTP 代理，类似于 Android 的配置方法。

使用 Xray

• 在开发过程中,Xray 会记录所有通过它处理的网络请求和 UI 更新。
• 在终端或命令行中输入 Xray 的命令，查看实时日志：

  # 查看所有请求
  ./xray requests
  # 查看 UI 更新
  ./xray UI

• Xray 会生成 HTML 报告，文件名为 index.html，可以在浏览器中查看详细信息。

导出日志

• 当你完成测试或调试时,可以导出 Xray 生成的日志文件。

  # 导出所有日志
  ./xray export

• 日志文件会保存在 Xray 的工作目录中，文件名为 xray.log。

使用场景

• 网络请求调试：分析网络请求的失败原因，如 404、500 错误，或者服务器响应内容。
• UI 更新问题：追踪 UI 更新的时间和流程，找出 UI 卡顿或延迟的原因。
• 性能监控：监控应用的网络流量和性能指标，优化资源使用。

注意事项

• 线路号配置：确保 Xray 的线路号与你的开发环境一致，否则无法接收请求。
• 权限设置：在 Android 和 iOS 项目中，确保有相应的权限配置，否则无法发送请求到 Xray。
• 日志处理：处理大量日志时，可以选择导出到文件或使用 Xray 的 CLI 工具进行分析。

通过以上步骤,你可以轻松使用 Xray 来分析和调试移动端应用的问题。