215 lines
6.5 KiB
Plaintext
215 lines
6.5 KiB
Plaintext
========================================
|
||
Android应用配置公网接口说明
|
||
========================================
|
||
|
||
一、已修改的配置文件
|
||
-------------------
|
||
|
||
【1. HttpConstants.java】
|
||
文件路径: peizhen/app/src/main/java/com/ruilaizi/service/okgonet/HttpConstants.java
|
||
|
||
修改前:
|
||
public static String URiBase = "https://ruilaizipj.com";//线上服务器
|
||
|
||
修改后:
|
||
public static String URiBase = "http://101.43.95.130:8039";//公网服务器地址
|
||
|
||
说明:
|
||
- 这是主要的HTTP常量配置类
|
||
- 所有使用 HttpConstants.URiBase 的接口都会使用新地址
|
||
- 包括登录、订单、用户信息等所有接口
|
||
|
||
【2. MyApi.java】
|
||
文件路径: peizhen/app/src/main/java/com/ruilaizi/service/network/http/MyApi.java
|
||
|
||
修改前:
|
||
public static String URiBase = "http://chengjie.free.idcfengye.com";
|
||
|
||
修改后:
|
||
public static String URiBase = "http://101.43.95.130:8039";//公网服务器地址
|
||
|
||
说明:
|
||
- Retrofit网络请求的基础URL配置
|
||
- 所有通过Retrofit发送的请求都会使用此地址
|
||
|
||
【3. API.java】
|
||
文件路径: peizhen/app/src/main/java/com/ruilaizi/service/main/activity/common/http/api/API.java
|
||
|
||
说明:
|
||
- 该类使用 HttpConstants.URiBase
|
||
- 会自动使用新配置的地址，无需修改
|
||
|
||
二、网络安全配置检查
|
||
-------------------
|
||
|
||
【1. network_security_config.xml】
|
||
文件路径: peizhen/app/src/main/res/xml/network_security_config.xml
|
||
|
||
当前配置:
|
||
<?xml version="1.0" encoding="utf-8"?>
|
||
<network-security-config>
|
||
<base-config cleartextTrafficPermitted="true" />
|
||
</network-security-config>
|
||
|
||
状态: ✓ 已配置，允许HTTP明文传输
|
||
|
||
【2. AndroidManifest.xml】
|
||
文件路径: peizhen/app/src/main/AndroidManifest.xml
|
||
|
||
检查项:
|
||
- ✓ INTERNET权限已配置
|
||
- ✓ networkSecurityConfig已引用: android:networkSecurityConfig="@xml/network_security_config"
|
||
|
||
状态: ✓ 配置正确
|
||
|
||
三、使用的接口地址
|
||
-----------------
|
||
|
||
所有网络请求现在会使用以下地址:
|
||
- 基础地址: http://101.43.95.130:8039
|
||
|
||
主要接口示例:
|
||
- 登录: http://101.43.95.130:8039/appLogin
|
||
- 短信登录: http://101.43.95.130:8039/smsLogin
|
||
- 获取个人信息: http://101.43.95.130:8039/system/user/getAppUserInfo
|
||
- 订单列表: http://101.43.95.130:8039/system/view/list
|
||
- 待接订单: http://101.43.95.130:8039/system/view/receiveOrderList
|
||
- 确认接单: http://101.43.95.130:8039/system/view/acceptOrderYes
|
||
- 拒绝接单: http://101.43.95.130:8039/system/view/acceptOrderNo
|
||
- 开始服务: http://101.43.95.130:8039/system/view/startServiceWithOrder
|
||
- 完成服务: http://101.43.95.130:8039/system/view/completeOrder
|
||
- 实名认证: http://101.43.95.130:8039/system/renzheng
|
||
- 上传图片: http://101.43.95.130:8039/system/oss/uploadMinioBase64
|
||
- 完善用户信息: http://101.43.95.130:8039/system/user/perfectUserInfo
|
||
|
||
四、编译和运行步骤
|
||
-----------------
|
||
|
||
1. 打开Android Studio
|
||
- 打开项目: peizhen目录
|
||
|
||
2. 同步Gradle
|
||
- 点击 "Sync Project with Gradle Files"
|
||
- 等待依赖下载完成
|
||
|
||
3. 编译项目
|
||
- Build → Make Project
|
||
- 或使用快捷键 Ctrl+F9 (Windows) / Cmd+F9 (Mac)
|
||
|
||
4. 运行应用
|
||
- 连接Android设备或启动模拟器
|
||
- 点击 Run 按钮
|
||
- 或使用快捷键 Shift+F10
|
||
|
||
5. 测试接口
|
||
- 打开应用
|
||
- 尝试登录功能
|
||
- 查看Logcat中的网络请求日志
|
||
- 确认请求地址为: http://101.43.95.130:8039/...
|
||
|
||
五、验证配置是否生效
|
||
-------------------
|
||
|
||
【方法1：查看Logcat日志】
|
||
1. 在Android Studio中打开Logcat
|
||
2. 过滤标签: OkHttp 或 Retrofit
|
||
3. 运行应用并执行网络请求
|
||
4. 查看请求URL是否为: http://101.43.95.130:8039/...
|
||
|
||
【方法2：使用抓包工具】
|
||
1. 使用Charles、Fiddler等抓包工具
|
||
2. 配置手机代理
|
||
3. 运行应用并执行网络请求
|
||
4. 查看实际请求的URL
|
||
|
||
【方法3：代码调试】
|
||
1. 在HttpConstants.java中设置断点
|
||
2. 查看URiBase的值
|
||
3. 确认是否为: http://101.43.95.130:8039
|
||
|
||
六、注意事项
|
||
-----------
|
||
|
||
1. HTTP vs HTTPS
|
||
- 当前使用HTTP协议（非加密传输）
|
||
- 生产环境强烈建议使用HTTPS
|
||
- 如果使用HTTPS，需要:
|
||
* 修改地址为: https://101.43.95.130:8039
|
||
* 配置SSL证书
|
||
* 或配置信任所有证书（仅开发环境）
|
||
|
||
2. 端口访问
|
||
- 确保服务器防火墙开放8039端口
|
||
- 确保Android设备能访问该IP和端口
|
||
- 如果使用移动网络，确保运营商未屏蔽该端口
|
||
|
||
3. 网络权限
|
||
- AndroidManifest.xml中已配置INTERNET权限
|
||
- 运行时需要授予网络权限（Android 6.0+）
|
||
|
||
4. 真机测试
|
||
- 确保手机能访问公网IP: 101.43.95.130
|
||
- 如果使用WiFi，确保路由器未限制
|
||
- 如果使用移动网络，确保能访问该IP
|
||
|
||
5. 调试建议
|
||
- 使用Android Studio的Logcat查看网络请求日志
|
||
- 检查OkHttp的日志拦截器输出
|
||
- 使用抓包工具（如Charles）查看实际请求和响应
|
||
- 检查返回的错误信息
|
||
|
||
6. 常见错误处理
|
||
- 连接超时: 检查网络连接和服务器状态
|
||
- SSL错误: 如果使用HTTPS，检查证书配置
|
||
- 401/403错误: 需要有效Token，这是正常的
|
||
- 404错误: 检查接口路径是否正确
|
||
|
||
七、如果无法连接服务器
|
||
---------------------
|
||
|
||
1. 检查服务器状态
|
||
- 确认后端服务是否运行在8039端口
|
||
- 使用测试脚本验证: python3 test_api.py
|
||
|
||
2. 检查网络连接
|
||
- 在手机上打开浏览器访问: http://101.43.95.130:8039
|
||
- 如果无法访问，检查网络配置
|
||
|
||
3. 检查防火墙
|
||
- 确认服务器防火墙开放8039端口
|
||
- 检查安全组规则（如果使用云服务器）
|
||
|
||
4. 使用内网地址（开发测试）
|
||
- 如果手机和服务器在同一局域网
|
||
- 可以使用内网IP: http://10.0.4.13:8039
|
||
- 修改HttpConstants.java和MyApi.java中的地址
|
||
|
||
5. 使用域名（推荐）
|
||
- 配置域名解析到服务器IP
|
||
- 使用域名访问: http://api.ruilaizi.com:8039
|
||
- 更便于管理和切换服务器
|
||
|
||
八、配置总结
|
||
-----------
|
||
|
||
✓ 已修改 HttpConstants.java - 主要接口地址
|
||
✓ 已修改 MyApi.java - Retrofit接口地址
|
||
✓ 已检查 network_security_config.xml - 允许HTTP
|
||
✓ 已检查 AndroidManifest.xml - 权限和配置正确
|
||
|
||
所有网络请求现在都会使用: http://101.43.95.130:8039
|
||
|
||
九、下一步操作
|
||
-------------
|
||
|
||
1. 重新编译Android应用
|
||
2. 安装到设备测试
|
||
3. 验证登录接口是否能正常连接
|
||
4. 测试其他业务接口
|
||
5. 根据测试结果调整配置
|
||
|
||
========================================
|
||
配置完成时间: 2024年
|
||
服务器地址: http://101.43.95.130:8039
|
||
========================================
|