first commit
This commit is contained in:
214
Android接口配置说明.txt
Normal file
214
Android接口配置说明.txt
Normal file
@@ -0,0 +1,214 @@
|
||||
========================================
|
||||
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
|
||||
========================================
|
||||
Reference in New Issue
Block a user