> ## Documentation Index
> Fetch the complete documentation index at: https://dragonwingdocs.qualcomm.com/llms.txt
> Use this file to discover all available pages before exploring further.

# 安装 Visual Studio Code

> 在安装 Qualcomm 扩展之前，先在 Ubuntu 或 Windows（配合 WSL）上设置 VS Code。

<Tabs>
  <Tab title="Windows (WSL)">
    <iframe src="https://players.brightcove.net/1414329538001/4JiZQnWhg_default/index.html?videoId=6396305824112" title="在 Windows 上开始使用 Qualcomm® VS Code 扩展" width="100%" height="420" allowFullScreen />

    ## 使用 WSL 的 Windows 设置

    该扩展运行在带有 Ubuntu 22.04 的 **WSL（Windows Subsystem for Linux）** 内部。Windows 是主机操作系统；编译和设备通信在 Ubuntu 中进行。

    <Warning>
      您的机器必须支持虚拟化。这可能需要在 BIOS/UEFI 设置中进行调整。
    </Warning>

    ### 1 — 安装 WSL 和 usbipd

    打开 Windows **管理员** 终端并运行：

    ```batch theme={null}
    wsl --install -d ubuntu-22.04
    winget install usbipd-win
    ```

    <Info>
      WSL 安装程序会提示您创建 Linux 用户名和密码。**请勿使用 `root`** — 该扩展需要一个普通用户账户。
    </Info>

    ### 2 — 重启并进入 WSL

    重启您的机器。然后在任意终端中：

    ```batch theme={null}
    wsl -d ubuntu-22.04
    ```

    ### 3 — 准备 Ubuntu 环境

    在 WSL Ubuntu shell 内部：

    ```bash theme={null}
    sudo apt update && sudo apt upgrade
    sudo locale-gen en_US.UTF-8
    sudo update-locale
    sudo apt-get install gcc bzip2 diffstat g++ adb
    ```

    ### 4 — 从 WSL 启动 VS Code

    ```bash theme={null}
    code .
    ```

    ### 5 — 安装 WSL 扩展

    在 VS Code 中，从 Marketplace 安装 **WSL** 扩展（由 Microsoft 提供）。请参阅[官方说明](https://code.visualstudio.com/docs/remote/wsl#_installation)。

    验证 VS Code 状态栏显示 **WSL: Ubuntu-22.04** — 请参阅 [From VS Code](https://code.visualstudio.com/docs/remote/wsl#_from-vs-code)。

    ### 6 — 将 USB 设备连接到 WSL

    在设备插入的情况下，按照 [USB 转发指南](wsl-usb)使用 `usbipd` 将设备从 Windows 转发到 WSL。
  </Tab>

  <Tab title="Ubuntu">
    ## Ubuntu 设置

    按照 [VS Code Linux 安装指南](https://code.visualstudio.com/docs/setup/linux)进行操作。

    <Warning>
      请从 VS Code 网站安装 `.deb` 软件包。该扩展**不支持 Snap Store 版本**。
    </Warning>

    验证安装：

    ```bash theme={null}
    code -v
    ```

    预期输出 — 版本、提交 SHA 和架构：

    ```text theme={null}
    1.78.1
    a4e8254e63e4b7a72896e74e12cc2098fcda1d6e
    x64
    ```

    ### 配置 udev 规则

    **配置 udev USB 规则（一次性前提条件）**

    Linux 内核使用 `udev` 控制对 USB 设备的访问。运行以下命令以允许 Qualcomm 厂商 ID `05c6`，从而无需每次操作都使用 `sudo`：

    ```bash theme={null}
    echo 'SUBSYSTEMS=="usb", ATTRS{idVendor}=="05c6", ATTRS{idProduct}=="9008", MODE="0666", GROUP="plugdev"
    SUBSYSTEMS=="usb", ATTRS{idVendor}=="05c6", ATTRS{idProduct}=="9135", MODE="0666", GROUP="plugdev"' \
      | sudo tee /etc/udev/rules.d/51-qcom-usb.rules
    ```

    重启 `udev` 以使更改生效：

    ```bash theme={null}
    sudo systemctl restart udev
    ```

    如果设备已经连接，请**拔下并重新插入**。

    <Note>
      请确保您的用户账户是 `plugdev` 组的成员。相关说明请参阅 [Android 开发者指南](https://developer.android.com/studio/run/device)。
    </Note>
  </Tab>
</Tabs>