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年
|
||
========================================
|