LinuxDo Android App

一个简洁的 Linux.do 网站 Android WebView 封装应用。可以直接下载 Apk 使用或者自己编译。

L站官网

LINUX DO

主要功能

• WebView 封装 - 完整加载 Linux.do 网站
• 下拉刷新 - 支持手势下拉刷新页面
• 文件上传支持 - 内置文件选择器
• 地理位置 - 支持网页地理位置请求
• 手势导航 - 左滑返回上一页
• 网络状态监听 - 自动检测网络恢复并重试
• SSL 证书处理 - 安全证书错误处理
• Cookie 管理 - 支持第三方 Cookie
• 页面加载超时 - 30秒超时检测
• 错误页面展示 - 友好的错误提示界面
• 深色模式支持 - 支持系统深色主题

技术栈

类别	技术	版本
语言	Java	17
构建工具	Gradle	8.2
Android Gradle Plugin	AGP	8.2.0
目标 SDK	Android	34 (Android 14)
最低支持 SDK	Android	21 (Android 5.0)
UI 组件库	Material Design Components	1.11.0
下拉刷新	SwipeRefreshLayout	1.1.0

环境要求

• JDK 17 或更高版本
• Android SDK API Level 34
• Android SDK Build Tools
• Gradle 8.2 (项目已内置 wrapper)

构建步骤

1. 克隆项目

git clone <repository-url>
cd LinuxDo

2. 配置 Android SDK

确保环境变量中设置了 ANDROID_HOME 指向 Android SDK 安装目录：

# Linux/macOS
export ANDROID_HOME=/path/to/android-sdk

# Windows
set ANDROID_HOME=C:\path\to\android-sdk

3. 构建项目

使用 Gradle Wrapper 构建 Debug 版本：

# Windows
.\gradlew.bat assembleDebug

# Linux/macOS
./gradlew assembleDebug

4. 安装运行

构建完成后，APK 文件位于：

app/build/outputs/apk/debug/app-debug.apk

可以通过以下方式安装：

# 使用 adb 安装
adb install app/build/outputs/apk/debug/app-debug.apk

项目结构

LinuxDo/
├── app/
│   └── src/main/
│       ├── java/com/linuxdo/app/
│       │   └── MainActivity.java      # 主活动（WebView 核心逻辑）
│       ├── res/
│       │   ├── layout/                # 布局文件
│       │   ├── drawable/              # 图片资源
│       │   ├── values/                # 字符串、颜色、样式
│       │   └── xml/                   # 网络安全配置等
│       └── AndroidManifest.xml        # 应用清单
├── build.gradle.kts                   # 项目构建配置
├── settings.gradle.kts                # Gradle 设置
└── gradle/wrapper/                    # Gradle Wrapper

构建变体

变体	说明	ProGuard
Debug	调试版本，关闭代码压缩	否
Release	发布版本，开启代码压缩和资源压缩	是

构建 Release 版本：

.\gradlew.bat assembleRelease

依赖说明

• com.google.android.material:material - Material Design 组件
• androidx.swiperefreshlayout:swiperefreshlayout - 下拉刷新布局