From 88e487b969f3d3e634cc4d1066362ce15bdc271e Mon Sep 17 00:00:00 2001
From: tianduanrui <tianduanrui@163.com>
Date: Thu, 17 Jun 2021 21:33:57 +0800
Subject: [PATCH] =?UTF-8?q?=E6=9B=B4=E6=96=B0=20wiki=20=EF=BC=8C=E6=B7=BB?=
 =?UTF-8?q?=E5=8A=A0=20wiki/LibQQt's-Need-Config-Environ-and-Building.md?=
 =?UTF-8?q?=20=E3=80=82?=
MIME-Version: 1.0
Content-Type: text/plain; charset=UTF-8
Content-Transfer-Encoding: 8bit

---
 ...oBuildLibQQt.md => How-to-Build-LibQQt.md} |  0
 ...bQQt's-Need-Config-Environ-and-Building.md | 90 +++++++++++++++++++
 wiki/wiki.md                                  |  3 +-
 3 files changed, 92 insertions(+), 1 deletion(-)
 rename wiki/{HowtoBuildLibQQt.md => How-to-Build-LibQQt.md} (100%)
 create mode 100644 wiki/LibQQt's-Need-Config-Environ-and-Building.md

diff --git a/wiki/HowtoBuildLibQQt.md b/wiki/How-to-Build-LibQQt.md
similarity index 100%
rename from wiki/HowtoBuildLibQQt.md
rename to wiki/How-to-Build-LibQQt.md
diff --git a/wiki/LibQQt's-Need-Config-Environ-and-Building.md b/wiki/LibQQt's-Need-Config-Environ-and-Building.md
new file mode 100644
index 00000000..03d0f8e0
--- /dev/null
+++ b/wiki/LibQQt's-Need-Config-Environ-and-Building.md
@@ -0,0 +1,90 @@
+# Build LibQQt Tips  
+
+1. 一般建议    
+使用Qt Creator编译，  
+或者使用PyMake提供环境从命令行编译，  
+或者使用PyQMake、PyAutoMake等专用编译工具编译。    
+2. 编译时间  
+LibQQt的编译时间2分钟-2小时，请合理安排时间。  
+
+# Environ and Building  
+
+## Qt Creator   
+
+1. Setting - Default building directory  
+    - 这是建议配置，LibQQt工程组织代码，已经不再依赖编译目录。
+    - [buildroot]/[projectname]/[kit.systemname]/[qtversion]/[buildtype]
+    - 需要在Qt Creator的Qt Kit页面对每个Qt Kit设置kit system name。
+2. Build Page
+    - 每个目标设置环境变量，设置QSYS，
+    - 针对QSYS的可取值，请查阅[LibQQt sourcecode]/multi-link/multi-link/add_platform.pri。  
+    - 常用的几个环境，LibQQt会自动设置QSYS，用户观察一下是否准确即可。
+    - 不准确的则自主设置。
+3. LibQQt自主技术设置【多链】
+    - 在电脑上，用户主目录/.qmake/app_configure.pri里设置，
+    - APP_BUILD_ROOT=...，建议设置，但是LibQQt不依赖。
+    - LIB_SDK_ROOT=...，必要设置，LibQQt发布SDK用，使用多链技术的Lib工程也用。真正发布到[LIB_SDK_ROOT]/QQt/[QSYS]/...
+    - APP_DEPLOY_ROOT=...，必要设置，依赖LibQQt的，使用多链技术的App工程用。  
+4. 开始编译
+    - qmake ...
+    - make ...
+
+## PyMake提供环境和开启编译  
+
+```json  
+
+Separate 环境的设置：
+    "path-assemblage": {
+        "root.prod": "...",
+        "root.sdk": "...",
+        "root.build": "...",
+        ...
+    },
+    "environ": {
+        "<env-name>": {
+            "path+": [
+                "path/to/qmake"
+                ...
+            ],
+            "QTDIR": "...",
+            "QTVERSION": "...",
+            "QTSPEC": "...",
+            "QTCONFIG": "...",
+            "QSYS": "...",
+            "QKIT": "... [maybe] [Multi-link Technology v1]",
+            "CMAKEGENERATOR": "...",
+            "makex": "...",
+            ...
+        }
+    }
+    
+```
+
+1. 使用PyMake工具详细的配置每个Separate环境。  
+1. LibQQt自主技术设置【多链】
+    - 在电脑上，用户主目录/.qmake/app_configure.pri里设置，
+    - APP_BUILD_ROOT=...，建议设置，但是LibQQt不依赖。
+    - LIB_SDK_ROOT=...，必要设置，LibQQt发布SDK用，使用多链技术的Lib工程也用。真正发布到[LIB_SDK_ROOT]/QQt/[QSYS]/...
+    - APP_DEPLOY_ROOT=...，必要设置，依赖LibQQt的，使用多链技术的App工程用。  
+1. 开始编译
+    - 切换到LibQQt源代码目录,  
+    - pymake use <env-name> ccvp here build.qmake QQt
+
+## 使用PyQMake-Gui编译  
+
+1. PyQMake依赖PyMake配置的每个Separate环境。
+1. PyQMake-Gui自动切换PyMake提供的环境，用户选取一个环境，点击环境名称，即可切换编译目标环境。
+1. PyQMake-Gui自动设置LibQQt的自主技术【多链】。
+1. 把 LibQQt 源代码目录的 QQt.pro 拖放到 PyQMake-Gui 窗口上。
+2. 点击Start Building即可。  
+
+## 使用PyAutoMake-Gui编译  
+
+1. PyAutoMake依赖PyMake配置的每个Separate环境。
+1. PyAutoMake-Gui自动切换PyMake提供的环境，用户选取一个环境，点击环境名称即可切换编译目标环境。
+1. PyAutoMake-Gui自动设置LibQQt的自主技术【多链】，其他使用多链技术的qmake工程同样可用。
+1. 把 LibQQt 源代码目录的 QQt.pro 拖放到 PyAutoMake-Gui 窗口上。
+2. 开始编译  
+    - 先点击configure，等待（qmake）完成，  
+    - 再点击Start Building。  
+
diff --git a/wiki/wiki.md b/wiki/wiki.md
index cde0cbed..2c185c14 100644
--- a/wiki/wiki.md
+++ b/wiki/wiki.md
@@ -6,7 +6,8 @@
 
 ## How to build LibQQt  
 
-[如何编译LibQQt](HowtoBuildLibQQt.md)  
+[如何编译LibQQt](How-to-Build-LibQQt.md)  
+[如何配置环境和编译LibQQt](LibQQt's-Need-Config-Environ-and-Building.md)  
 
 ## QQt On Android