Skip to content
体验新版
项目
组织
正在加载...
登录
切换导航
打开侧边栏
Ronaldo_717
unidocs-zh
提交
ec7aadd5
U
unidocs-zh
项目概览
Ronaldo_717
/
unidocs-zh
与 Fork 源项目一致
Fork自
DCloud / unidocs-zh
通知
1
Star
0
Fork
0
代码
文件
提交
分支
Tags
贡献者
分支图
Diff
Issue
0
列表
看板
标记
里程碑
合并请求
0
DevOps
流水线
流水线任务
计划
Wiki
0
Wiki
分析
仓库
DevOps
项目成员
Pages
U
unidocs-zh
项目概览
项目概览
详情
发布
仓库
仓库
文件
提交
分支
标签
贡献者
分支图
比较
Issue
0
Issue
0
列表
看板
标记
里程碑
合并请求
0
合并请求
0
Pages
DevOps
DevOps
流水线
流水线任务
计划
分析
分析
仓库分析
DevOps
Wiki
0
Wiki
成员
成员
收起侧边栏
关闭侧边栏
动态
分支图
创建新Issue
流水线任务
提交
Issue看板
前往新版Gitcode,体验更适合开发者的 AI 搜索 >>
提交
ec7aadd5
编写于
3月 14, 2023
作者:
DCloud-yyl
浏览文件
操作
浏览文件
下载
电子邮件补丁
差异文件
添加App端User Agent文档
上级
44f3bc80
变更
2
隐藏空白更改
内联
并排
Showing
2 changed file
with
58 addition
and
0 deletion
+58
-0
docs/tutorial/_sidebar.md
docs/tutorial/_sidebar.md
+1
-0
docs/tutorial/app-useragent.md
docs/tutorial/app-useragent.md
+57
-0
未找到文件。
docs/tutorial/_sidebar.md
浏览文件 @
ec7aadd5
...
...
@@ -47,6 +47,7 @@
*
[
Native.js
](
/tutorial/native-js.md
)
*
[
renderjs
](
/tutorial/renderjs.md
)
*
[
原生插件
](
https://nativesupport.dcloud.net.cn/NativePlugin/README
)
*
[
App的User Agent
](
/tutorial/app-useragent.md
)
*
[
App使用高斯模糊
](
/tutorial/app-blureffect.md
)
*
App 打包配置
*
[
基础配置
](
/tutorial/app-base.md
)
...
...
docs/tutorial/app-useragent.md
0 → 100644
浏览文件 @
ec7aadd5
用户代理(User Agent,简称 UA),是http/https网络请求头中的一个特殊字符串,使服务器能够识别客户端使用的操作系统及版本、浏览器渲染引擎、内核版本等信息。uni-app中的vue页面使用系统Webview渲染,为了保持一致,App端所有http/https网络请求头使用统一的User Agent。
API包括
[
uni.request
](
https://uniapp.dcloud.net.cn/api/request/request.html#request
)
、
[
uni.uploadFile
](
https://uniapp.dcloud.net.cn/api/request/network-file.html#uploadfile
)
、
[
uni.downloadFile
](
https://uniapp.dcloud.net.cn/api/request/network-file.html#downloadfile
)
等
组件包括
[
image
](
https://uniapp.dcloud.net.cn/component/image.html
)
、
[
web-view
](
https://uniapp.dcloud.net.cn/component/web-view.html
)
等。
### 默认User Agent
默认情况使用系统Webview的User Agent,并添加Html5Plus/1.0、uni-app两字段
-
Android平台,在荣耀Play4T手机上默认值为:
```
Mozilla/5.0 (Linux; Android 10; AKA-AL10 Build/HONORAKA-AL10; wv) AppleWebKit/537.36 (KHTML, like Gecko) Version/4.0 Chrome/88.0.4324.93 Mobile Safari/537.36 uni-app Html5Plus/1.0 (Immersed/34.5)
```
-
iOS平台,在iPhone 12手机上默认值为:
```
Mozilla/5.0 (iPhone; CPU iPhone OS 15_5 like Mac OS X) AppleWebKit/605.1.15 (KHTML, like Gecko) Mobile/15E148 Html5Plus/1.0 (Immersed/20) uni-app
```
### 自定义User Agent
如需自定义User Agent,在项目的 manifest.json 中 "app-plus" -> "useragent" 进行配置,支持以下属性:
-
value
字符串类型,表示要添加的自定义User Agent值
-
concatenate
boolean类型, true表示在默认User Agent基础上添加额外字段,false表示替换默认User Agent
注意:
-
如需单独定义Android平台的User Agent,可设置"useragent_android",在Android平台存在"useragent_android"时会覆盖"useragent"配置
-
如需单独定义iOS平台的User Agent,可设置"useragent_ios",在iOS平台存在"useragent_ios"时会覆盖"useragent"配置
-
配置自定义User Agent后需提交云端打包才能生效
#### 在默认User Agent中添加额外字段
如需在默认User Agent中添加myua字段,可配置如下:
```
json
{
"app-plus"
:
{
"useragent"
:
{
"value"
:
"myua"
,
"concatenate"
:
true
}
}
}
```
#### 替换默认User Agent
如需完全自定义User Agent为"CustomUA",可配置如下:
```
json
{
"app-plus"
:
{
"useragent"
:
{
"value"
:
"CustomUA"
,
"concatenate"
:
false
}
}
}
```
`注意:此时默认UA信息中的操作系统及版本、浏览器渲染引擎、内核版本等信息将丢失,实际项目中不建议使用替换默认User Agent。`
编辑
预览
Markdown
is supported
0%
请重试
或
添加新附件
.
添加附件
取消
You are about to add
0
people
to the discussion. Proceed with caution.
先完成此消息的编辑!
取消
想要评论请
注册
或
登录