dongguaTV 安卓客户端怎么构建？一篇配图教程教你用 GitHub 生成 APK

前几天写了一篇自建 Netflix？别再满世界找片了，一键部署 E视界解决问题。部署好只能通过浏览器观影。开发者也提供了安卓客户端，但需要自己构建安卓客户端。开发者提供的构建说明也挺简单明了，但缺少截图，对于很少接触 Github 的用户还不够友好。我就抽点时间配合开发者的说明配图写了这篇文章，需要的话可以对照构建自己专属的安卓影视客户端。需要自己有 Github 账户并可以正常访问。

🔀 Fork 仓库

打开 https://github.com/EdNovas/dongguaTV 并 Fork

💻 构建安卓应用

🔧 方法一：自定义构建 (推荐)

无需修改代码，直接在 GitHub 网页上自定义并构建 APP，推荐小白不折腾直接用：

1. 进入仓库 Actions 页面。

2. 在左侧选择 "Android Build & Release"。

3. 点击右侧的 Run workflow 按钮。

4. 输入配置信息：

Server URL: 您的服务器地址 (例如 http://http://192.168.123.238:3660)
App Name: App 名称 (例如 我的私人影院)
Version Tag: 版本号 (例如 v1.0.0)

5. 点击 Run workflow 开始构建。

6. 等待构建完成

7. 在 Releases 页面即可下载定制的 apk。

🔧 方法二：代码修改方式 (高级)

如果你希望永久修改默认配置，就需要修改代码并推送到自己 Fork 的仓库中：

1.编辑 `capacitor.config.json`，修改 `server.url` 为您的服务器地址：

{
  "appId": "com.ednovas.donguatv",
  "appName": "E视界",
  "webDir": "public",
  "server": {
    "url": "https://your-server.com",
    "cleartext": true
  }
}

2. 提交更改并推送 Tag 触发自动构建：

git add capacitor.config.json
git commit -m "修改服务器地址"
git tag v1.0.0
git push origin main --tags

3. 或者本地手动构建：

npm install
npx cap sync android
cd android && ./gradlew assembleRelease

APK 位于 `android/app/build/outputs/apk/release/`

📱 安卓客户端使用

1. 安装成功后，默认打开登录界面，输入 Docker 部署设置的密码。

2. 登录成功后就可以正常观影。

🏠 关于内网 HTTP 使用的说明

⚠️ 重要提示：安卓9(API 28)开始，系统默认不允许明文HTTP流量。如果你的APP连不上HTTP服务器，请检查下面的设置对不对。

可能遇到的问题：

APP在安卓电视/手机上一直卡在加载页面
浏览器能正常打开 http://192.168.x.x:3660，但是APP不行
控制台报错 net::ERR_CLEARTEXT_NOT_PERMITTED

解决方法：

这个项目已经设置好了HTTP支持。如果你用GitHub Actions自动构建，或者在本地构建，生成的APK会自动支持HTTP访问。

用 GitHub Actions 构建内网 APK：

进入 Actions -> Android Build & Release -> Run workflow
填上你的内网服务器地址，比如：http://192.168.x.x:3660
构建完下载APK，就能正常访问HTTP服务了。

注意事项：

capacitor.config.json 里的 cleartext: true 是Capacitor的设置，但是安卓9以上，还要加上面说的安卓原生设置才行。
如果你是自己手动构建APK，请确定你的项目代码是最新的（包含上面说的配置）。
为了避免DNS解析出错，建议用固定IP地址，不要用主机名。