From 75855ddb1547228d55329c77311787f2b3708e10 Mon Sep 17 00:00:00 2001
From: yutent <yutent.io@gmail.com>
Date: Fri, 8 Sep 2023 19:16:47 +0800
Subject: [PATCH] Update create_setting

---
 create_setting.md | 8 ++++++++
 1 file changed, 8 insertions(+)

diff --git a/create_setting.md b/create_setting.md
index fa89f14..af02975 100644
--- a/create_setting.md
+++ b/create_setting.md
@@ -15,10 +15,16 @@
 另外, 除了以上默认配置, 提供了以下5个自定义设置(通过`create_setting()`创建新的设置, 也可以通过访问`webengine`实例的`get_settings()`方法获取当前的设置对象)
 
 - `useragent` 修改'webkit的`useragent`,  默认值为 `Mozilla/5.0 (X11; Linux x86_64) AppleWebKit/605.1.15 (KHTML, like Gecko) Version/16.4 Safari/605.1.15 WebEngine/{sdk_serverion}`
+- `app_name` 应用名称 , 会被应用在上面的user_agent中, 代替SDK的名字 【0.7.0新增】
+- `app_version` 应用版本号, 同上, 代替的是SDK的版本号 【0.7.0新增】
 - 'web_security' 可禁用`web security`, 禁用之后, 可以不受跨域限制, 可以方便实现一些业务, 如API测试工具、调用其他第三方提供的API等。
 - `disable_fullscreen` 禁用全屏, 可满足某些业务场景下, 不允许webapp全屏的需求。
 - `devtools`, 启动开发者控制台, 方便开发过程中进行代码调试
 - `mock_devices`, 模拟捕获设备的API, 方便开发人员可以在没有真实设备的情况下进行捕获设备相关的功能测试和调试。
+  > 【0.4.0】之后, 合并到devtools中, 不再支持单独设置
+
+
+**注意:** 若同时设置`useragent`和`app_name, app_version`时,`app_name, app_version`不会被注入到最终的`useragent`中
 
 
 ```python
@@ -27,6 +33,8 @@ from webengine.gtk3 import WebEngine create_setting
 web = WebEngine()
 setting = create_setting({
   "useragent": "...",
+  "app_name": "A_NEW_APP",
+  "app_version": "1.0.0",
   "web_security": False,
   "disable_fullscreen": True,
   "devtools": True,