path: root/README.md

在Archlinux及衍生发行版上运行QQ
========

<p align="center">
  <a href="https://github.com/vufa/deepin-wine-qq-arch/actions">
    <img src="https://img.shields.io/github/workflow/status/vufa/deepin-wine-qq-arch/CI/action?logo=github&style=flat-square" alt="Build Status">
  </a>
  <a href="https://im.qq.com/download/">
    <img src="https://img.shields.io/badge/QQ-9.5.2.27897-blue?style=flat-square&logo=tencent-qq" alt="QQ Version">
  </a>
  <a href="https://aur.archlinux.org/packages/deepin-wine-qq/">
    <img src="https://img.shields.io/aur/version/deepin-wine-qq?label=AUR&logo=arch-linux&style=flat-square" alt="AUR Version">
  </a>
  <a href="https://github.com/vufa/deepin-wine-qq-arch/releases">
    <img src="https://img.shields.io/github/downloads/vufa/deepin-wine-qq-arch/total?logo=github&style=flat-square" alt="GitHub Release">
  </a>
  <a href="https://github.com/vufa/deepin-wine-qq-arch/issues">
    <img src="https://img.shields.io/github/issues/vufa/deepin-wine-qq-arch?logo=github&style=flat-square" alt="GitHub Issues">
  </a>
</p>

Deepin 打包的 QQ 容器(`com.qq.im.deepin`)移植到 Archlinux，包含定制的运行脚本，QQ 安装包替换为官方最新

:warning: `deepin-wine-qq` 从 `v9.5.2.27897-1` 开始，默认使用AUR仓库 [deepin-wine5](https://aur.archlinux.org/packages/deepin-wine5/)，不再依赖 `wine`，可以进行一些清理操作来保持系统整洁，具体参照： [从 `wine`/`deepin-wine 2.x` 迁移](#从-winedeepin-wine-2x-迁移)

<!-- TOC -->

- [安装](#安装)
    - [从AUR安装](#从aur安装)
    - [用安装包安装](#用安装包安装)
    - [本地打包安装](#本地打包安装)
- [设置](#设置)
- [兼容性记录](#兼容性记录)
- [切换到 `deepin-wine`](#切换到-deepin-wine)
    - [自动切换(推荐)](#自动切换推荐)
    - [从 `wine`/`deepin-wine 2.x` 迁移](#从-winedeepin-wine-2x-迁移)
- [卸载](#卸载)
- [常见问题及解决](#常见问题及解决)
    - [QQ 安全组件异常](#qq-安全组件异常)
    - [不能记住密码](#不能记住密码)
    - [网络连接状态改变后不能重连](#网络连接状态改变后不能重连)
    - [高分辨率屏幕支持](#高分辨率屏幕支持)
    - [GNOME 桌面上的悬浮窗口问题](#gnome-桌面上的悬浮窗口问题)
    - [防止使用系统安装的 Windows 字体](#防止使用系统安装的-windows-字体)
    - [不能启动/卡死/卡顿问题](#不能启动卡死卡顿问题)
    - [字体发虚/使用其他字体](#字体发虚使用其他字体)
- [感谢](#感谢)
- [更新日志](#更新日志)

<!-- /TOC -->

## 安装

`deepin-wine-qq` 依赖`Multilib`仓库中的一些32位库，Archlinux默认没有开启 `Multilib`仓库，需要编辑`/etc/pacman.conf`，取消对应行前面的注释([Archlinux wiki](https://wiki.archlinux.org/index.php/Official_repositories#multilib)):

```diff
# If you want to run 32 bit applications on your x86_64 system,
# enable the multilib repositories as required here.

#[multilib-testing]
#Include = /etc/pacman.d/mirrorlist

-#[multilib]
-#Include = /etc/pacman.d/mirrorlist
+[multilib]
+Include = /etc/pacman.d/mirrorlist
```

:warning: **注意：由于新版QQ可能需要 `wine` 还没有实现的一些win api，这会导致一些功能不可用，安装前先根据[兼容性记录](#兼容性记录)选择一个合适的版本**

:bulb: 以下三种安装方式效果相同，选择一种即可

### 从AUR安装

已添加到 AUR [deepin-wine-qq](https://aur.archlinux.org/packages/deepin-wine-qq/)，可使用 `yay` 或 `yaourt` 安装：

```shell
yay -S deepin-wine-qq
```

### 用安装包安装

> 由 [GitHub Action](https://github.com/vufa/deepin-wine-qq-arch/actions) 在 Docker 容器 [countstarlight/makepkg](https://hub.docker.com/r/countstarlight/makepkg) 中自动构建的 ArchLinux 安装包

在 [GitHub Release](https://github.com/vufa/deepin-wine-qq-arch/releases) 页面下载后缀为 `.pkg.tar.xz` 或 `.pkg.tar.zst` 的安装包，使用`pacman`安装：

```bash
sudo pacman -U #下载的包名
```

`.md5` 文件用于校验包完整性：

```bash
md5sum -c *.md5
```

### 本地打包安装

```shell
 git clone https://github.com/vufa/deepin-wine-qq-arch.git

 cd deepin-wine-qq-arch
  
 makepkg -si
```

用上述三种安装方式之一安装完成后，运行应用菜单中创建的 QQ 快捷方式，首次运行会用 QQ 的安装包进行安装

:warning: **注意：安装QQ时不建议修改安装路径，如果修改默认路径，要对应修改 `deepin-wine-qq` 的启动脚本(`/opt/apps/com.qq.im.deepin/files/run.sh`)：**

```bash
EXEC_PATH="c:/Program Files/Tencent/QQ/Bin/QQ.exe"
```
改为修改后的安装路径，否则只有安装后第一次能够运行

:bulb: **NOTE: 前几次运行时可能会提示 "qq安全组件异常"，等一会再运行或重启一下系统**

## 设置

dpi，目录映射等可以在 `winecfg` 进行设置，打开 `winecfg` 的命令为：

```bash
/opt/apps/com.qq.im.deepin/files/run.sh winecfg
```

## 兼容性记录

|     QQ      |  wine  |   兼容性   |             备注             | deepin-wine | 兼容性 | 备注 |
| :---------: | :----: | :--------: | :--------------------------: | :---------: | :----: | :--: |
| 9.4.9.27847 |  6.12  |            |                              |  5.0.16-1   |  支持  |      |
| 9.4.8.27843 |  6.10  |            |                              |  5.0.16-1   |  支持  |      |
| 9.4.7.27805 |  6.8   |            |                              |  5.0.16-1   |  支持  |      |
| 9.4.6.27770 |  6.5   |            |                              |  5.0.16-1   |  支持  |      |
| 9.4.5.27743 |  6.5   |    部分    |                              |  5.0.16-1   |  支持  |      |
| 9.4.3.27712 |  6.1   |    部分    | 部分字体显示为方框且性能较差 |  5.0.16-1   |  支持  |      |
| 9.4.2.27666 |  6.0   |    部分    | 部分字体显示为方框且性能较差 |  5.0.16-1   |  支持  |      |
| 9.4.2.27658 |  5.22  |    部分    | 部分字体显示为方框且性能较差 |  5.0.16-1   |  支持  |      |
| 9.4.2.27655 |  5.22  |    支持    |                              |  5.0.16-1   |  支持  |      |
| 9.4.1.27572 |  5.22  | **不支持** |                              |  5.0.16-1   |  支持  |      |
| 9.4.0.27525 |  5.21  | **不支持** |                              |  2.18_24-3  |  支持  |      |
| 9.3.9.27427 |  5.19  |    支持    |                              |  2.18_24-3  |  支持  |      |
| 9.3.8.27381 |  5.17  | **不支持** |           无法启动           |  2.18_24-3  |  支持  |      |
| 9.3.7.27301 |  5.15  |    支持    |                              |  2.18_24-3  |  支持  |      |
| 9.3.6.27263 |  5.12  |    支持    |                              |  2.18_22-3  |  支持  |      |
| 9.3.5.27030 |  5.10  |    支持    |                              |  2.18_22-3  |  支持  |      |
| 9.3.3.27011 |  5.9   |    支持    |                              |  2.18_22-3  |  支持  |      |
| 9.3.3.27009 |  5.8   |    支持    |                              |  2.18_22-3  |  支持  |      |
| 9.3.2.26869 |  5.8   |    支持    |                              |  2.18_22-3  |  支持  |      |
| 9.1.8.26211 | 4.20-1 |    支持    |                              |             |        |      |
| 9.1.8.26211 | 4.18-1 |    部分    |      不能使用中文输入法      |             |        |      |
| 9.1.8.26211 | 4.17-1 |    部分    |      不能使用中文输入法      |             |        |      |
| 9.1.8.26211 | 4.16-1 |    支持    |                              |             |        |      |

## 切换到 `deepin-wine`

:warning: `deepin-wine-qq` 从 `v9.5.0.27852-1` 开始，默认使用AUR仓库 [deepin-wine5](https://aur.archlinux.org/packages/deepin-wine5/)，无需再进行任何切换操作，对于之前的版本，可以查看[旧版README](https://github.com/vufa/deepin-wine-qq-arch/blob/827052484c4fd05c165c28f4a227e1773a21332d/README.md)。

### 自动切换(推荐)

对于之前的版本，可以查看[旧版README](https://github.com/vufa/deepin-wine-qq-arch/blob/827052484c4fd05c165c28f4a227e1773a21332d/README.md)。

### 从 `wine`/`deepin-wine 2.x` 迁移

更新到 `deepin-wine-qq v9.5.0.27852-1` 及之后的版本后，依赖变更为 `deepin-wine5`，

如果此时没有其他应用在使用 `wine`, `deepin-wine 2.x` 和 `deepin-wine6-stable`，就可以放心的卸载 `wine`, `deepin-wine 2.x` 和 `deepin-wine6-stable` 及其依赖：

```bash
# 卸载 deepin-wine 2.x (如果有)
sudo pacman -S lib32-freetype2 #用原版替换lib32-freetype2-infinality-ultimate
sudo pacman -Rns deepin-wine xsettingsd # 卸载 deepin-wine 2.x

# 卸载 deepin-wine6-stable (如果有)
sudo pacman -Rns deepin-wine6-stable

# 卸载 wine (如果有)
sudo pacman -Rns wine wine-mono wine-gecko
```

同时，`deepin-wine-helper` 改为使用AUR仓库[deepin-wine-helper](https://aur.archlinux.org/packages/deepin-wine-helper)，可以删除之前的 `deepin-wine-helper`：

```bash
rm -rf $HOME/.deepinwine/deepin-wine-helper
```

## 卸载

无论用何种方式安装，卸载都是：

```bash
sudo pacman -Rns deepin-wine-qq
```

卸载的同时会删除用户目录下的整个 `WINEPREFIX` 环境，路径为：`~/.deepinwine/Deepin-QQ`

QQ在本地保存的数据不会被删除，如保存在用户文档下的数据(默认：`~/Documents/Tencent Files`)

## 常见问题及解决

### QQ 安全组件异常

前几次运行时可能会出现该问题，由残留的安装进程导致，可以等一会再运行或重启一下系统

### 不能记住密码

对于之前的版本，可以查看[旧版README](https://github.com/vufa/deepin-wine-qq-arch/blob/827052484c4fd05c165c28f4a227e1773a21332d/README.md)。

### 网络连接状态改变后不能重连

对于之前的版本，可以查看[旧版README](https://github.com/vufa/deepin-wine-qq-arch/blob/827052484c4fd05c165c28f4a227e1773a21332d/README.md)。

### 高分辨率屏幕支持

参照[设置](#设置)打开 `winecfg` ，在选项卡 `Graphics` 中修改dpi，如 修改为`192`

### GNOME 桌面上的悬浮窗口问题

> 根据 [deepin-wine-tim-arch#2](https://github.com/vufa/deepin-wine-tim-arch/issues/2)，由[EricDracula](https://github.com/EricDracula)提供的方法

安装 GNOME 插件: [TopIcons Plus](https://extensions.gnome.org/extension/1031/topicons/)


### 防止使用系统安装的 Windows 字体

> 参照 https://blog.zhullyb.top/2021/04/27/hide-simsun-from-deepin-wine-tim/

假设 Windows 字体都安装在 `/usr/share/fonts/TTF/` 目录下

先安装 `bubblewrap`：
```bash
sudo pacman -S bubblewrap --needed
```

然后每次用如下命令启动QQ:
```bash
bwrap --dev-bind / / --tmpfs /usr/share/fonts/TTF/ /opt/apps/com.qq.im.deepin/files/run.sh
```

也可以修改 `deepin-wine-qq` 的应用菜单 `/usr/share/applications/com.qq.im.deepin.desktop`：
```diff
#!/usr/bin/env xdg-open

[Desktop Entry]
Encoding=UTF-8
Type=Application
X-Created-By=Deepin WINE Team
Categories=chat;Network;
Icon=com.qq.im.deepin
-Exec="/opt/apps/com.qq.im.deepin/files/run.sh"
+Exec="bwrap --dev-bind / / --tmpfs /usr/share/fonts/TTF/ /opt/apps/com.qq.im.deepin/files/run.sh"
Name=QQ
Name[zh_CN]=QQ
Comment=Tencent QQ Client on Deepin Wine
StartupWMClass=QQ.exe
MimeType=

```
就可以和之前一样通过应用菜单中的QQ图标启动

:warning: **注意：对 `/usr/share/applications/com.qq.im.deepin.desktop` 的修改会在重装或更新后被覆盖**

### 不能启动/卡死/卡顿问题

> 由 [AUR](https://aur.archlinux.org/packages/com.tencent.meeting.deepin/) 的 [huyz](https://aur.archlinux.org/account/huyz) 提供的方法

如果你在系统里安装了 windows 的宋体（simsun.ttc），则需复制一份 `simsun.ttc` 到 wine 容器（`$HOME/.deepinwine/Deepin-QQ/drive_c/windows/fonts`）里，否则程序可能会崩溃。

> 参照 [deepin-wine-qq-arch#19](https://github.com/vufa/deepin-wine-qq-arch/issues/19)

用原版 `dwrite.dll` 替换 `$HOME/.deepinwine/Deepin-QQ/drive_c/windows/system32/dwrite.dll`

再参照[设置](#设置)打开 `winecfg`，在 `Libraries` 中新增一项 `dwrite`，将新增的 `dwrite` 设置为原装先于内建(Native then Builtin)。

### 字体发虚/使用其他字体

默认使用文泉驿微米黑(`wqy-microhei`)字体，可以使用Windows平台常用字体替代，直接将字体文件或字体链接文件放置到字体文件夹就会生效，不会影响系统字体

字体文件夹在：`$HOME/.deepinwine/Deepin-QQ/drive_c/windows/Fonts`

经测试将 `微软雅黑` 伪装成 `宋体(simsun)` 的显示效果最好，具体可以参照 [bbs.deepin.org](https://bbs.deepin.org/zh/post/213530?offset=0&postId=1269543)，将 `fake_simsun.ttc` 放到字体文件夹

## 感谢

* [Wuhan Deepin Technology Co.,Ltd.](http://www.deepin.org/)

* [@wszqkzqk](https://github.com/wszqkzqk) 的 [wszqkzqk-deepin-wine-tim-arch](https://github.com/wszqkzqk/wszqkzqk-deepin-wine-tim-arch)

* [@ssfdust](https://github.com/ssfdust) 的 [wszqkzqk-deepin-wine-tim-arch](https://github.com/ssfdust/wszqkzqk-deepin-wine-tim-arch)

## 更新日志

<details open>
<summary>2021</summary>

* 2021-11-12 QQ-9.5.2.27897
* 2021-10-08 QQ-9.5.1.27888
* 2021-08-25 QQ-9.5.0.27852
* 2021-07-16 QQ-9.4.9.27849
* 2021-07-09 QQ-9.4.9.27847
* 2021-06-14 QQ-9.4.8.27843
* 2021-05-11 QQ-9.4.7.27805
* 2021-04-08 QQ-9.4.6.27770
* 2021-04-02 QQ-9.4.5.27743
* 2021-02-11 QQ-9.4.3.27712 9.3.2deepin20
* 2021-02-08 QQ-9.4.3.27712
* 2021-01-19 QQ-9.4.2.27666
* 2021-01-05 QQ-9.4.2.27658

</details>
<details>
<summary>2020</summary>

* 2020-12-29 QQ-9.4.2.27655
* 2020-12-24 QQ-9.4.1.27572 com.qq.im.deepin_9.3.2deepin14
* 2020-11-12 QQ-9.4.0.27525
* 2020-10-18 QQ-9.3.9.27427
* 2020-09-13 QQ-9.3.8.27381
* 2020-08-16 QQ-9.3.7.27301
* 2020-07-19 QQ-9.3.6.27263
* 2020-06-19 QQ-9.3.5.27030
* 2020-06-05 QQ-9.3.3.27011
* 2020-05-22 QQ-9.3.3.27009
* 2020-05-11 QQ-9.3.2.26869

</details>
<details>
<summary>2019</summary>

* 2019-11-17 QQ-9.1.8.26211 deepin.com.qq.im_9.1.8deepin0
* 2019-09-21 QQ-9.1.8.26211 deepin.com.qq.im_8.9.19983deepin23
* 2019-04-19 QQ-9.1.1.24953
* 2019-03-18 QQ-9.1.0.24712
* 2019-03-06 QQ-9.0.9.24445
* 2019-02-05 QQ-9.0.9_1

</details>
<details>
<summary>2017</summary>

* 2017-12-31 QQ-8.9.6

</details>