uni-app 在 linux wine 上使用 HBuilderX

发布于 1周前 作者 itying888 来自 Uni-App

uni-app 在 linux wine 上使用 HBuilderX
前言： 因linux上没有itunes，无法真机运行App；linux上无法运行微信等小程序开发工具。这些问题暂时无法解决。所以DCloud暂时不会投入很多精力开发纯正的linux版，目前提供linux上的2个方案

  1. linux的cli方案，可以调用HBuilderX的cli，适于在linux服务器上调用cli进行运行、发行等工程自动化方案。具体另见：链接
  2. wine环境的解决方案，如下：

1. Linux在wine上使用HBuilderX的注意事项

wine上运行HBuilderX, 优缺点如下：

  • HBuilderX支持打开、编辑各种文本文件
  • 支持web项目开发（web普通项目、vue项目等）
  • 支持uniapp h5开发
  • 不支持真机运行5+app、uniapp等项目，由于受第三方工具的影响（具体可参考5.1章节）
  • 各种小程序工具，包含微信小程序、支付宝小程序等，既不支持linux，也不支持在wine下使用。

2. HBuilderX在wine上运行效果

先来看下，wine + HBuilderX的运行效果

wine + HBuilderX的运行效果

3. wine环境安装

3.1 Linux环境说明

  • HBuilderX在Linux wine上的运行，必须安装Linux桌面操作系统
  • 以下所有的操作，都是基于ubuntu操作系统
  • 如果您使用其它Linux发行版，如Redhat Fedora SUSE等，安装wine，请参考wine官方文档
  • 如果您在其它Linux桌面操作系统使用wine + HBuilderX，遇到问题，可以反馈给我们。

3.2 wine文档

在安装wine过程中，可能遇到其它问题，请参考官方文档:

3.3 wine安装

特别注意，下面操作使用到的apt相关的命令，只适用于ubuntu、deb等系统；并不是所有的linux发行版都有apt命令。 其它发行版安装wine，请参考wine官方文档

如果您使用的是 64 位系统，请开启 32 bit 架构支持（如果您之前没有开启的话）：

$ sudo dpkg --add-architecture i386

下载添加仓库密钥：

$ wget -nc https://dl.winehq.org/wine-builds/winehq.key  
$ sudo apt-key add winehq.key

添加仓库:

$ sudo apt-add-repository 'deb https://dl.winehq.org/wine-builds/ubuntu/ bionic main'

更新安装包：

$ sudo apt update

然后安装 以下任一一个安装包：

稳定分支(选择):

sudo apt install --install-recommends winehq-stable  
如果失败  
sudo apt-get update  
sudo apt install --install-recommends winehq-stable

开发分支:

$ sudo apt install --install-recommends winehq-devel

Staging 分支:

$ sudo apt install --install-recommends winehq-staging

（可能需要安装 wine-mono、wine-gecko，点击确定即可）

安装完成之后：

$ wine --version

3.4 wine配置（1)

配置wine:

$ winecfg

此命令会提示安装 wine-mono、wine-gecko，点击确定即可。 但这个安装过程可能会很慢，要看网速。

wine配置

3.5 wine配置（2)

安装wine-gecko，请点击确定

wine配置

3.6 wine配置（3)

wine配置，应用程序默认设置，如下图，请点击确定

wine配置

4. HBuilderX：安装启动

4.1 HBuilderX下载、解压

  1. 打开 HBuilderX官网 下载Windows HBuilderX安装包
  2. HBuilderX安装包是一个压缩包，需要解压

HBuilderX下载

4.2 HBuilderX 程序启动

  • 在终端上，进入HBuilderX解压后的目录, 输入 wine HBuilderX.exe
  • 直接双击exe程序
  • 单击右键exe程序，选择打开方式也可以选择Wine打开。

4.3. HBuilderX启动后可能遇到的问题

使用wine启动HBuidlerX.exe后，可能会遇到无法显示顶部菜单的问题

解决方法：使用alt+t s 快捷键打开系统设置，选择使用原生windows窗口样式

HBuilderX启动后可能遇到的问题

5. 其它

5.1 问题：为什么5+app、uniapp项目，无法运行到真机和小程序？

原因：

  • ios真机运行依赖于itunes
  • 微信小程序开发者工具、以及其它小程序厂商本身也没有提供linux版本；并且各大windows小程序开发者工具在wine下运行也会出现各种错误

Harmonyos Next教程
1 回复

在 Linux 系统上通过 Wine 运行 HBuilderX 以开发 uni-app 项目，虽然这不是一个标准的或推荐的开发环境配置，但确实是可以实现的。以下是一个基本的步骤指南和代码示例，帮助你设置和运行这一环境。

1. 安装 Wine

首先，你需要在 Linux 上安装 Wine。以下是在 Ubuntu 上的安装命令：

sudo dpkg --add-architecture i386
sudo apt update
sudo apt install --install-recommends winehq-stable

2. 下载并安装 HBuilderX

接下来，从 DCloud 官网下载 HBuilderX 的 Windows 版本安装包（.exe 文件）。使用 Wine 运行安装程序：

wine path/to/HBuilderX_Setup.exe

确保将 path/to/HBuilderX_Setup.exe 替换为实际下载的安装包路径。

3. 配置环境变量（可选）

为了方便运行 HBuilderX，你可能需要将 Wine 的路径添加到系统的 PATH 环境变量中，或者创建一个桌面快捷方式。

4. 创建并运行 uni-app 项目

现在，你可以通过 Wine 运行 HBuilderX。以下命令假设你已经完成了安装，并且 HBuilderX 的可执行文件位于默认的 Wine 安装路径下：

wine "C:\\Program Files\\HBuilderX\\HBuilderX.exe"

在 HBuilderX 中，创建一个新的 uni-app 项目：

  • 打开 HBuilderX。
  • 选择“文件”->“新建”->“项目”。
  • 选择“uni-app”模板，并填写项目名称和路径。
  • 点击“创建”。

5. 示例代码

在创建好的 uni-app 项目中，你会有一个基本的项目结构。以下是一个简单的 App.vue 示例：

<template>
  <view>
    <text>{{ message }}</text>
  </view>
</template>

<script>
export default {
  data() {
    return {
      message: 'Hello, uni-app on Linux with Wine!'
    };
  }
}
</script>

<style>
/* 添加一些简单的样式 */
view {
  justify-content: center;
  align-items: center;
  height: 100vh;
  background-color: #f5f5f5;
}
text {
  font-size: 24px;
  color: #333;
}
</style>

注意事项

  • 由于 Wine 对 Windows 应用程序的兼容性问题，性能和稳定性可能不如在原生 Windows 系统上运行的好。
  • 确保你的 Linux 系统具有足够的资源（如内存和存储空间）来运行 Wine 和 HBuilderX。
  • 定期更新 Wine 和 HBuilderX 以获取最新的功能和修复。

通过上述步骤，你应该能够在 Linux 上通过 Wine 成功运行 HBuilderX 并开发 uni-app 项目。

回到顶部