Skip to content

安装

本页面将指导您完成 uniapp 开发工具的安装过程。

选择安装方式

uniapp 开发工具提供两种安装方式:

  1. utools 插件 - 适合 utools 用户,安装快捷,自动更新
  2. 独立安装包 - 适合所有用户,无需额外依赖

请根据您的需求选择合适的安装方式。

方式一:utools 插件安装

前置要求

快速安装

推荐方式:直接从插件市场安装

👉 点击这里直接安装

点击上方链接将打开 utools 插件详情页,点击"安装"即可。

手动安装步骤

  1. 打开 utools

    使用快捷键打开 utools:

    • Windows/Linux: Alt + Space
    • macOS: Option + Space
  2. 搜索插件

    在 utools 搜索框中输入:

    uniapp应用开发工具
  3. 安装插件

    • 在搜索结果中找到"uniapp应用开发工具"插件
    • 点击插件卡片
    • 点击"安装"按钮
    • 等待安装完成
  4. 启动工具

    安装完成后,在 utools 中输入关键词即可启动:

    uniapp

更新插件

utools 插件会自动检查更新。您也可以手动更新:

  1. 在 utools 中输入 插件管理
  2. 找到"uniapp 开发工具"
  3. 如果有新版本,点击"更新"

方式二:独立安装包安装

下载安装包

前往下载页面选择适合您系统的安装包:

  • Windows: uniapp-tools-windows-x64.exe
  • Mac Intel: uniapp-tools-mac-intel.dmg
  • Mac ARM: uniapp-tools-mac-arm.dmg

Windows 安装

  1. 下载安装包

    下载 uniapp-tools-windows-x64.exe 文件

  2. 运行安装程序

    双击下载的 .exe 文件启动安装向导

  3. 安装选项

    • 选择安装路径(推荐使用默认路径)
    • 选择是否创建桌面快捷方式
    • 点击"安装"
  4. 完成安装

    • 等待安装完成
    • 勾选"运行 uniapp 开发工具"
    • 点击"完成"

Mac 安装

  1. 下载安装包

    根据您的 Mac 芯片类型下载对应的 .dmg 文件:

    • Intel 芯片: uniapp-tools-mac-intel.dmg
    • Apple Silicon (M1/M2/M3): uniapp-tools-mac-arm.dmg
  2. 打开 DMG 文件

    双击下载的 .dmg 文件

  3. 安装应用

    • 将"uniapp 开发工具"图标拖拽到"Applications"文件夹
    • 等待复制完成
  4. 首次运行

    从启动台或应用程序文件夹打开应用

macOS 安全提示

如果遇到"无法打开,因为来自身份不明的开发者"的提示:

方法一:

  1. 打开"系统偏好设置" > "安全性与隐私"
  2. 在"通用"标签页中,点击"仍要打开"按钮

方法二:

  1. 右键点击应用图标
  2. 选择"打开"
  3. 在弹出的对话框中点击"打开"

验证安装

安装完成后,验证工具是否正确安装:

检查版本

打开应用后,在主界面或关于页面查看版本信息:

  • 版本号应显示为 v1.0.0 或更高
  • 确认平台信息正确(Windows/Mac Intel/Mac ARM)

基本功能测试

  1. 检查是否能正常打开应用界面
  2. 检查菜单栏和工具栏是否正常显示
  3. 尝试打开帮助文档

系统要求

Windows

  • 操作系统: Windows 10 (64-bit) 或更高版本
  • 内存: 至少 4GB RAM
  • 磁盘空间: 至少 500MB 可用空间
  • 其他: .NET Framework 4.7.2 或更高版本

macOS

  • 操作系统:
    • Intel: macOS 10.15 (Catalina) 或更高版本
    • Apple Silicon: macOS 11.0 (Big Sur) 或更高版本
  • 内存: 至少 4GB RAM
  • 磁盘空间: 至少 500MB 可用空间

常见问题

Windows 安装失败

问题: 提示"无法安装"或"安装程序错误"

解决方案:

  1. 确认系统是 64 位 Windows 10 或更高版本
  2. 检查是否有足够的磁盘空间
  3. 尝试以管理员身份运行安装程序
  4. 关闭杀毒软件后重试

Mac 无法打开应用

问题: 提示"应用已损坏"或"无法验证开发者"

解决方案:

  1. 打开终端,运行以下命令:
    bash
    sudo xattr -r -d com.apple.quarantine /Applications/uniapp开发工具.app
  2. 输入管理员密码
  3. 重新打开应用

安装后找不到应用

Windows:

  • 检查开始菜单中的程序列表
  • 检查桌面是否有快捷方式
  • 查看默认安装路径:C:\Program Files\uniapp开发工具\

macOS:

  • 从启动台查找
  • 打开访达,前往"应用程序"文件夹
  • 使用 Spotlight 搜索(Cmd + Space

卸载

Windows 卸载

  1. 打开"设置" > "应用" > "应用和功能"
  2. 找到"uniapp 开发工具"
  3. 点击"卸载"
  4. 按照提示完成卸载

macOS 卸载

  1. 打开访达,前往"应用程序"文件夹
  2. 找到"uniapp 开发工具"
  3. 拖拽到废纸篓,或右键选择"移到废纸篓"
  4. 清空废纸篓

下一步

安装完成后,您可以:

如果遇到问题,请访问 GitHub Issues 寻求帮助。

Released under the MIT License.