深耕数码、AI兴趣领域
16
40
冬瓜TV安卓客户端怎么构建？一篇配图教程教你用 GitHub 生成 APK
2026-01-04 19:40:11
7点赞
50收藏
1评论
前几天写了一篇
部署好只能通过浏览器观影。开发者也提供了安卓客户端，但需要自己构建安卓客户端。开发者提供的构建说明也挺简单明了，但缺少截图，对于很少接触 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.dongguatv",
"appName": "E视界",
"webDir": "public",
"server": {
"url": "https://your-server.com",
"cleartext": true
}
}
2. 提交更改并推送 Tag 触发自动构建：
# 1. 添加文件到暂存区
git add capacitor.config.json
# 2. 提交更改到本地仓库
git commit -m "修改服务器地址"
# 3. 创建标签（版本号）
git tag v1.0.0
# 4. 推送提交和标签到远程仓库
git push origin main --tags
3. 或者本地手动构建：
# 1. 安装依赖
npm install
# 2. 同步 Capacitor 配置到原生平台
npx cap sync android
# 3. 进入 Android 目录并构建发布版本 APK
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地址，不要用主机名。
作者声明本文无利益相关，欢迎值友理性交流，和谐讨论～
