docs: update FAQ with latest additions#718
Conversation
There was a problem hiding this comment.
Code Review
This pull request updates the FAQ documentation in both English and Chinese, adding new sections on offline deployment, local build troubleshooting, component parameter passing, and specific fixes for Email and Excel components. The review feedback identifies incorrect dependency names and file paths in the 'Dependency Trimming' section of the local build guide, providing specific corrections to match the project's configuration.
| **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 and the file path mentioned here do not match the project's configuration. In engine/components/astronverse-database/pyproject.toml, the dependencies are named psycopg2-binary and cx_Oracle. Also, the path should be relative to the repository root without a leading slash. Furthermore, note that astronverse-database is currently excluded from the workspace members in build.bat (line 225), which means these dependencies are not processed by default during a standard build.
| 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 and the file path mentioned here do not match the project's configuration. In engine/components/astronverse-database/pyproject.toml, the dependencies are named psycopg2-binary and cx_Oracle. Also, the path should be relative to the repository root without a leading slash. Furthermore, note that astronverse-database is currently excluded from the workspace members in build.bat (line 225), which means these dependencies are not processed by default during a standard build.
| 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` 等依赖,以绕过复杂的本地编译。 |
Supplement FAQ.md and FAQ.zh.md based on Astron RPA FAQ.zh_26.2.1.md