docs: update FAQ with latest additions#720
Conversation
|
FenjuFu seems not to be a GitHub user. You need a GitHub account to be able to sign the CLA. If you have already a GitHub account, please add the email address used for this commit to your account. You have signed the CLA already but the status is still pending? Let us recheck it. |
There was a problem hiding this comment.
Code Review
This pull request updates the FAQ documentation in both English and Chinese by adding several new Q&A sections. These additions cover offline deployment via Docker, troubleshooting local build dependency issues, front-end and back-end separation, component parameter passing, and fixes for specific automation components like Email and Excel. The review feedback correctly identifies that the dependency names mentioned in the troubleshooting section should be updated to match the exact names used in the project's configuration file for better clarity.
| **A:** | ||
| 1. **C++ Build Environment**: Ensure Microsoft Visual C++ 14.0 or higher is installed (including MSVC v143 and Win10/11 SDK). | ||
| 2. **Permission Issue**: Please run the build script with Administrator privileges. | ||
| 3. **Dependency Trimming**: If specific database drivers (like Oracle/PostgreSQL) are not needed in the current scenario, you can modify `/engine/components/astronverse-database/pyproject.toml` and remove dependencies like `psycopg2` and `cx-oracle` to bypass complex local compilation. |
There was a problem hiding this comment.
The dependency names mentioned here do not exactly match the ones defined in engine/components/astronverse-database/pyproject.toml. In that file, they are listed as psycopg2-binary and cx_Oracle. Using the exact names will help users find and remove them more easily, especially since cx_Oracle uses an underscore and specific casing.
| 3. **Dependency Trimming**: If specific database drivers (like Oracle/PostgreSQL) are not needed in the current scenario, you can modify `/engine/components/astronverse-database/pyproject.toml` and remove dependencies like `psycopg2` and `cx-oracle` to bypass complex local compilation. | |
| 3. **Dependency Trimming**: If specific database drivers (like Oracle/PostgreSQL) are not needed in the current scenario, you can modify `/engine/components/astronverse-database/pyproject.toml` and remove dependencies like `psycopg2-binary` and `cx_Oracle` to bypass complex local compilation. |
| **A:** | ||
| 1. **C++ 编译环境**:确保已安装 Microsoft Visual C++ 14.0 或更高版本(包含 MSVC v143 和 Win10/11 SDK)。 | ||
| 2. **权限问题**:请使用管理员权限(Administrator)运行构建脚本。 | ||
| 3. **依赖裁剪**:如果当前场景不需要特定数据库驱动(如 Oracle/PostgreSQL),可以修改 `/engine/components/astronverse-database/pyproject.toml`,移除 `psycopg2` 和 `cx-oracle` 等依赖,以绕过复杂的本地编译。 |
There was a problem hiding this comment.
The dependency names mentioned here do not exactly match the ones defined in engine/components/astronverse-database/pyproject.toml. In that file, they are listed as psycopg2-binary and cx_Oracle. Using the exact names will help users find and remove them more easily, especially since cx_Oracle uses an underscore and specific casing.
| 3. **依赖裁剪**:如果当前场景不需要特定数据库驱动(如 Oracle/PostgreSQL),可以修改 `/engine/components/astronverse-database/pyproject.toml`,移除 `psycopg2` 和 `cx-oracle` 等依赖,以绕过复杂的本地编译。 | |
| 3. **依赖裁剪**:如果当前场景不需要特定数据库驱动(如 Oracle/PostgreSQL),可以修改 `/engine/components/astronverse-database/pyproject.toml`,移除 `psycopg2-binary` 和 `cx_Oracle` 等依赖,以绕过复杂的本地编译。 |
Co-authored-by: FenjuFu <fenjufu@example.com>

Supplement FAQ.md and FAQ.zh.md based on Astron RPA FAQ.zh_26.2.1.md