123 lines
3.7 KiB
Plaintext
123 lines
3.7 KiB
Plaintext
|
========================================
|
|||
|
|
Android应用配置公网接口说明
|
|||
|
|
========================================
|
|||
|
|
|
|||
|
|
一、已修改的配置文件
|
|||
|
|
-------------------
|
|||
|
|
|
|||
|
|
1. HttpConstants.java
|
|||
|
|
文件路径: peizhen/app/src/main/java/com/ruilaizi/service/okgonet/HttpConstants.java
|
|||
|
|
修改内容:
|
|||
|
|
- 原地址: "https://ruilaizipj.com"
|
|||
|
|
- 新地址: "http://101.43.95.130:8039"
|
|||
|
|
|
|||
|
|
说明: 这是主要的HTTP常量配置类，所有使用HttpConstants.URiBase的接口都会使用新地址
|
|||
|
|
|
|||
|
|
2. MyApi.java
|
|||
|
|
文件路径: peizhen/app/src/main/java/com/ruilaizi/service/network/http/MyApi.java
|
|||
|
|
修改内容:
|
|||
|
|
- 原地址: "http://chengjie.free.idcfengye.com"
|
|||
|
|
- 新地址: "http://101.43.95.130:8039"
|
|||
|
|
|
|||
|
|
说明: Retrofit网络请求的基础URL配置
|
|||
|
|
|
|||
|
|
3. API.java
|
|||
|
|
文件路径: peizhen/app/src/main/java/com/ruilaizi/service/main/activity/common/http/api/API.java
|
|||
|
|
说明: 该类使用HttpConstants.URiBase，会自动使用新地址
|
|||
|
|
|
|||
|
|
二、网络安全配置
|
|||
|
|
---------------
|
|||
|
|
|
|||
|
|
Android 9.0+ (API 28+) 默认不允许HTTP明文传输，需要配置允许HTTP连接。
|
|||
|
|
|
|||
|
|
1. network_security_config.xml
|
|||
|
|
文件路径: peizhen/app/src/main/res/xml/network_security_config.xml
|
|||
|
|
当前配置: 已允许明文传输 (cleartextTrafficPermitted="true")
|
|||
|
|
|
|||
|
|
配置内容:
|
|||
|
|
<?xml version="1.0" encoding="utf-8"?>
|
|||
|
|
<network-security-config>
|
|||
|
|
<base-config cleartextTrafficPermitted="true" />
|
|||
|
|
</network-security-config>
|
|||
|
|
|
|||
|
|
2. AndroidManifest.xml
|
|||
|
|
需要确保在<application>标签中引用网络安全配置:
|
|||
|
|
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/system/user/getAppUserInfo
|
|||
|
|
- 订单列表: http://101.43.95.130:8039/system/view/list
|
|||
|
|
- 接单: http://101.43.95.130:8039/system/view/acceptOrderYes
|
|||
|
|
- 等等...
|
|||
|
|
|
|||
|
|
四、编译和运行
|
|||
|
|
-------------
|
|||
|
|
|
|||
|
|
1. 使用Android Studio打开项目
|
|||
|
|
2. 同步Gradle依赖
|
|||
|
|
3. 编译Debug或Release版本
|
|||
|
|
4. 安装到设备或模拟器
|
|||
|
|
5. 运行应用测试接口连接
|
|||
|
|
|
|||
|
|
五、注意事项
|
|||
|
|
-----------
|
|||
|
|
|
|||
|
|
1. HTTP vs HTTPS
|
|||
|
|
- 当前使用HTTP协议（非加密）
|
|||
|
|
- 生产环境建议使用HTTPS（需要SSL证书）
|
|||
|
|
- 如果使用HTTPS，需要修改地址为: https://101.43.95.130:8039
|
|||
|
|
- 并配置相应的SSL证书
|
|||
|
|
|
|||
|
|
2. 端口访问
|
|||
|
|
- 确保服务器防火墙开放8039端口
|
|||
|
|
- 确保Android设备能访问该IP和端口
|
|||
|
|
|
|||
|
|
3. 网络权限
|
|||
|
|
- AndroidManifest.xml中需要INTERNET权限
|
|||
|
|
- 检查是否已配置
|
|||
|
|
|
|||
|
|
4. 真机测试
|
|||
|
|
- 确保手机和服务器在同一网络或能访问公网IP
|
|||
|
|
- 如果使用内网IP，需要确保手机在同一局域网
|
|||
|
|
|
|||
|
|
5. 调试建议
|
|||
|
|
- 使用Android Studio的Logcat查看网络请求日志
|
|||
|
|
- 检查OkHttp的日志拦截器输出
|
|||
|
|
- 使用抓包工具（如Charles）查看实际请求
|
|||
|
|
|
|||
|
|
六、验证配置
|
|||
|
|
-----------
|
|||
|
|
|
|||
|
|
1. 编译应用后，在Logcat中查看网络请求日志
|
|||
|
|
2. 检查请求URL是否为: http://101.43.95.130:8039/...
|
|||
|
|
3. 测试登录接口是否能正常连接
|
|||
|
|
4. 检查返回数据是否正确
|
|||
|
|
|
|||
|
|
七、常见问题
|
|||
|
|
-----------
|
|||
|
|
|
|||
|
|
Q1: 无法连接到服务器
|
|||
|
|
A1: 检查网络连接、防火墙设置、服务器是否运行
|
|||
|
|
|
|||
|
|
Q2: SSL错误
|
|||
|
|
A2: 如果使用HTTPS，需要配置SSL证书或信任所有证书（仅开发环境）
|
|||
|
|
|
|||
|
|
Q3: 401/403错误
|
|||
|
|
A3: 这是正常的，表示接口存在但需要有效Token认证
|
|||
|
|
|
|||
|
|
Q4: 网络超时
|
|||
|
|
A4: 检查服务器响应时间，可能需要增加超时时间配置
|
|||
|
|
|
|||
|
|
========================================
|
|||
|
|
配置完成时间: 2024年
|
|||
|
|
========================================
|