AirLogistics - 航空物流信息管理系统

一款专业的航空物流管理Android应用，为机场货运站提供全流程数字化解决方案，涵盖国内外货物进出港、仓储管理、车辆调度等核心业务。

项目信息

• 版本: 1.7.9
• 最低支持: Android 7.0 (API 24)
• 目标版本: Android 10 (API 30)
• 开发语言: Kotlin + Java
• 架构模式: MVVM + 组件化

核心功能

国内出港 (GNC)

• 货物收运管理
• 复磅称重（地磅集成）
• 转运管理
• 出库装机
• 仓库管理
• 数据查询与统计

国内进港 (GNJ)

• 舱单管理
• 卸机入库
• 出库提货
• 移库管理
• 货物交接
• 实时查询

国际出港 (GJC)

• 国际货物收运
• 板箱组装
• ULD容器管理
• 复磅称重
• 仓储移库

国际进港 (GJJ)

• 国际舱单管理
• 报文解析
• 理货管理
• 出库操作
• 货物交接

其他功能

• 航班查询与管理
• 货物状态追踪
• 运输日志
• 监装监卸管理
• 车辆调度与统计
• 消息与电报管理
• 事故签证处理

技术特性

架构设计

• 组件化架构: 模块间解耦，支持独立开发调试
• MVVM模式: 数据驱动，清晰的业务逻辑分层
• 协程异步: Kotlin Coroutines + Flow 实现响应式编程
• 模块路由: ARouter实现模块间通信

核心技术

• 网络框架: Retrofit + OkHttp
• 数据解析: FastJSON + Gson
• UI框架: Material Design + DataBinding
• 图表展示: MPAndroidChart定制版
• 蓝牙打印: 佳博打印SDK集成
• 扫码功能: ZXing条码扫描
• 屏幕适配: AutoSize横屏适配方案

快速开始

环境要求

• Android Studio Arctic Fox (2020.3.1) 或更高版本
• JDK 1.8
• Gradle 7.3.3
• Kotlin 1.6.21

依赖配置

如遇依赖下载问题，请参考以下步骤：

1. 下载 gradle-7.3.3-bin.zip

   • 百度网盘: https://pan.baidu.com/s/18wsuGRlNxjMYbxLhBH9yeg
   • 提取码: 1029

2. 在 Android Studio 中打开设置:

   • Settings → Build, Execution, Deployment → Build Tools → Gradle
   • 解压下载的文件并替换 "Gradle user home" 目录中的对应文件夹

构建项目

# 克隆项目
git clone [repository-url]
cd aerologic-app

# 构建Debug版本
./gradlew assembleDebug

# 构建Release版本
./gradlew assembleRelease

# 安装到设备
./gradlew installDebug

组件化开发

项目支持组件化开发模式，可独立运行各业务模块：

1. 编辑 gradle.properties 文件
2. 修改 isBuildModule=true（独立模块）或 false（集成模式）
3. Sync项目并运行对应模块

项目结构

aerologic-app/
├── app/                    # 应用主模块
├── module_base/           # 基础库模块（核心）
├── module_gnc/            # 国内出港
├── module_gnj/            # 国内进港
├── module_gjc/            # 国际出港
├── module_gjj/            # 国际进港
├── module_hangban/        # 航班管理
├── module_cargo/          # 货物追踪
├── module_mit/            # 监装监卸
├── module_p/              # PDA功能
├── Printer/               # 蓝牙打印
├── MPChartLib/            # 图表库
└── CLAUDE.md              # 开发指南

开发文档

详细的开发指南请参考 CLAUDE.md，包含：

• 完整的架构说明
• API调用规范
• 开发模板代码
• 常见业务场景实现
• 技术栈使用指南

配置说明

网络配置

内网服务器地址配置位置：

• module_base/src/main/res/values/strings.xml
• system_url_inner: 主服务器地址
• weight_url: 地磅服务器地址

签名配置

Release版本签名信息：

• KeyStore: key.jks
• 密码: 123321
• 别名: key

分支管理

• develop: 主开发分支
• feature/*: 功能开发分支
• release/*: 发布分支

许可证

[根据实际情况添加许可证信息]

联系方式

[根据实际情况添加联系方式]

---

注意: 本项目为企业内部系统，包含敏感业务信息和配置，请勿外传。