一个功能完整的 Android 短网址管理应用，配合短网址服务器使用。

查看详细构建说明: BUILD.md

快速构建:

chmod +x build.sh
./build.sh

或使用 Android Studio:

1. 打开 Android Studio
2. 导入项目 (android 目录)
3. Build > Build Bundle(s) / APK(s) > Build APK(s)

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

启动后端服务器:

cd ..
python app.py

在应用中配置服务器地址:

• 模拟器: http://10.0.2.2:5000
• 真实设备: http://YOUR_IP:5000

• ✅ 创建短网址: 支持自动生成或自定义短码
• ✅ 查看列表: 显示所有短网址及详细信息
• ✅ 统计信息: 总链接数和总访问量
• ✅ 复制功能: 一键复制短网址到剪贴板
• ✅ 删除功能: 删除不需要的短网址
• ✅ 刷新功能: 支持按钮刷新和下拉刷新
• ✅ 服务器配置: 灵活配置服务器地址
• ✅ Material Design: 现代化的界面设计

（TODO: 添加应用截图）

• 语言: Java
• 最小 SDK: API 24 (Android 7.0)
• 目标 SDK: API 34 (Android 14)
• 架构: 单 Activity + RecyclerView
• 网络: OkHttp 4.12.0
• JSON: Gson 2.10.1
• UI: Material Components

android/
├── app/                          # 应用模块
│   ├── src/main/
│   │   ├── java/com/urlshortener/
│   │   │   ├── MainActivity.java       # 主界面
│   │   │   ├── ApiService.java         # API 服务
│   │   │   ├── UrlAdapter.java         # 列表适配器
│   │   │   └── models/                 # 数据模型
│   │   └── res/                        # 资源文件
│   │       ├── layout/                 # 布局
│   │       ├── values/                 # 字符串、颜色等
│   │       └── mipmap-*/              # 应用图标
│   └── build.gradle                    # 应用配置
├── build.gradle                        # 项目配置
├── BUILD.md                            # 详细构建文档
├── TEST.md                             # 测试文档
└── build.sh                            # 自动构建脚本

1. 输入完整的 URL (如: https://www.example.com)
2. (可选) 输入自定义短码
3. 点击"生成短网址"
4. 成功后短网址会自动显示并复制到剪贴板

• 列表显示所有短网址
• 点击"复制"复制短网址
• 点击"删除"删除短网址
• 下拉刷新或点击"刷新"按钮更新数据

1. 点击右上角菜单
2. 选择"设置"
3. 输入服务器地址
4. 点击"保存"

查看详细测试文档: TEST.md

运行基本测试:

1. 启动后端服务器
2. 安装并启动应用
3. 配置服务器地址
4. 按照 TEST.md 中的测试清单进行测试

Q: 无法连接服务器

• 确保服务器正在运行
• 检查服务器地址配置
• 模拟器使用 10.0.2.2 代替 localhost

Q: 构建失败

• 检查 ANDROID_HOME 环境变量
• 确保已安装 API Level 34
• 运行 ./gradlew clean

Q: 应用崩溃

• 检查 logcat: adb logcat | grep urlshortener
• 确保 URL 格式正确 (http:// 或 https://)

• JDK 11+
• Android SDK (API 34)
• Gradle 8.0+
• Android Studio (推荐)

# Debug 版本
./gradlew assembleDebug

# Release 版本
./gradlew assembleRelease

# 清理
./gradlew clean

# 运行测试
./gradlew test

• 使用 Java 8 语法
• 遵循 Android 开发最佳实践
• 使用 Material Design 组件
• 注重性能和内存优化

欢迎提交 Issue 和 Pull Request!

本项目仅供学习和参考使用。

• 后端项目文档
• 构建文档
• 测试文档

• 初始版本
• 实现基本的短网址管理功能
• Material Design UI
• 支持创建、查看、删除短网址
• 统计信息展示