OpenShamrock/docs/guide/getting-started.md
2023-10-29 10:49:45 +08:00

4.5 KiB
Raw Blame History

title icon
快速开始 rocket

::: warning 注意 Shamrock 的更新会围绕一个稳定的版本,如果盲目升级,可能导致 Shamrock 不可用。
Shamrock 仍然处于快速开发阶段可能会有大量API在未来版本中被删除或修改。
请不要过度依赖实验室中的功能,以免造成不必要的损失。 :::

下载

::: tip 提示 目前推荐您下载 开发版本 的 Shamrock :::

稳定版本

开发版本

  • 要下载 Shamrock 的开发版本(推荐),请访问 GitHub Actions

部署

::: warning 注意 请使用Shamrock兼容的QQ客户端部署支持的QQ版本 如果您使用了 QRSpeed/ShamrockNative 有关的插件,请确保 Shamrock 存活。
无论什么情况都请确保 QQ 客户端 存活。
禁止对 QQ 客户端 隐藏 Shamrock这将导致无法运行。
首次启动,必须打开 Shamrock否则无法推送配置文件导致失败。 :::

模拟器上部署

在Mumu模拟器、逍遥模拟器......各种模拟器其中对Shamrock兼容较好的是Mumu模拟器其它模拟器在测试情况下都出现高版本QQ闪退的问题。

检查您是否拥有Root权限尝试安装安卓Xposed框架注意的是 Shamrock必须是ALL版本才能在模拟器正常使用

推荐的是Xposed的Lsposed框架而不是EdXposed在测试情况下EdXP出现了无法注入的问题。

如果您没有办法安装Xposed框架请尝试使用Lspatch需要安卓9.0+。请不要下载其他人Patch的版本其它人修改的QQ请前往github下载正确的Lspatch的jar或者apk手动patch你想要的版本需要Shamrock支持该版本。Patch之后即使您使用的是便携模式您依旧需要将QQ和Shamrock安装在同一个环境。

在Linux类服务器上部署使用docker

这个选择过于多元化你可以使用redroid、docker-android需要注意的是部分框架要求开起虚拟化才能使用哦目前依旧是采用Lspatch+Shamrock方案在docker部署因为安装magisk类需要修补镜像难以实现。

在PVE上使用Windows部署

使用PVE安装任意Windows系统之后阅读文章 虚拟化透传(镶套虚拟化) 之后可在系统内使用安卓模拟器部署。

在PVE上直接部署BlissOS

操作视频参考PVE下安装BlissOS及Magisk,LSP
之后可以直接使用OpenShamrock

在那Linux KVM部署

参考文章:KVM上部署Android 该文章使用的安卓版本可能较低请使用安卓9+系统

在WSA上部署

WSA拥有自带Magisk的版本但是QQ在WSA在第二次启动时会闪退怀疑为热更新问题。

有 XP 环境

  • 打开 QQ 客户端,登录你的 QQ 账号
  • 安装 Shamrock 并在 Xposed 启用 Shamrock 模块,如果使用 LSPosed 则需要勾选模块作用域(默认QQ)
  • 启动 Shamrock 并重新启动 QQ 客户端,如果环境为 Xposed 则需要重启手机
  • 此时 Shamrock 会显示已激活(需要成功登陆,才会显示已激活)

无 Root 环境

使用 LSPatch

  • 打开 LSPatch 并在管理页面选择 + 新建修补可以选择从存储目录选择QQAPK或者直接使用已经安装过的QQ
  • 修补模式默认且应该优先选择本地模式,这样方便直接更新 Shamrock 模块而不用重新修补,缺点是需要 LSPatch 保持后台运行
  • 其他配置保持默认,然后点击开始修补,修补完成后会提示安装(如果已经安装会提示卸载)
  • 安装 Shamrock 模块后在管理页面点击修补好的 QQ 选择模块作用域 勾选上 Shamrock 模块然后保存
  • 启动 Shamrock 并重新启动 QQ 客户端
  • 此时 Shamrock 会显示已激活

::: warning 注意 使用本地模式修补后需要保持LSPatch在后台运行优点是模块更新无需重新修补QQ 使用集成模式修补后无需保持LSPatch在后台运行缺点是模块更新后需要重新修补QQ :::

使用 VirtualXposed

::: warning 注意 在 Android 12 以上的系统中,使用 VirtualXposed 会导致闪退。 :::

使用 太极

::: warning 注意 暂不支持太极使用,正在申请。 :::