运行apio verify时提示oss-cad-suite未安装的问题求助

环境与问题概述 #

• 系统：Windows 11
• Python版本：3.7.9
• APIO版本：0.8.3
• 操作场景：使用apio examples -d icestick\leds生成的示例项目（已手动修改apio.ini适配APIO 0.8.3），执行apio verify时提示oss-cad-suite未安装
• 自动安装失败原因：执行apio install oss-cad-suite时，APIO错误匹配32位下载链接（windows_x86），尝试降级为通用windows链接时触发404错误
• 手动安装无效：已手动下载对应版本tools-oss-cad-suite-windows_amd64-0.0.8.tar.gz并解压到C:\Users\[user]\.apio\packages，修改文件夹名为oss-cad-suite、调整package.json名称字段后，apio install --list仍显示该包未安装，apio verify依旧报错

相关错误日志 #

执行apio verify的错误 #

PS C:\Users\[user]\scripts\apio\icestick\leds> apio verify
(DEBUG) Profile path: C:\Users\[user]\.apio\profile.json
(DEBUG) Home_dir: C:\Users\[user]\.apio
Error: package 'oss-cad-suite' is not installed
Please run:
   apio install oss-cad-suite
Error: Package not installed

执行apio install oss-cad-suite的错误 #

PS C:\Users\[user]\scripts\apio\icestick\leds> python --version
Python 3.7.9
PS C:\Users\[user]\scripts\apio\icestick\leds> apio --version
apio, version 0.8.3
PS C:\Users\[user]\scripts\apio\icestick\leds> apio install oss-cad-suite
(DEBUG) Profile path: C:\Users\[user]\.apio\profile.json
(DEBUG) Home_dir: C:\Users\[user]\.apio
File version.txt downloaded!
Version: 0.0.8
Installing oss-cad-suite package:
platform_download_url: https://github.com/FPGAwars/tools-oss-cad-suite/releases/download/v0.0.8/tools-oss-cad-suite-windows_x86-0.0.8.tar.gz
Warning: full platform does not match: windows_x86
         Trying OS name: windows
Error: Got an unrecognized status code '404' when downloaded https://github.com/FPGAwars/tools-oss-cad-suite/releases/download/v0.0.8/tools-oss-cad-suite-windows-0.0.8.tar.gz

执行apio install --list的结果 #

Not installed packages:

----------------------------------------------------------------------------
Name        Description
----------------------------------------------------------------------------
oss-cad-suite YosysHQ/oss-cad-suite

解决办法 #

APIO识别已安装包依赖profile.json文件的记录，手动安装后需要手动更新该文件：

1. 打开C:\Users\[user]\.apio\profile.json文件（如果不存在则手动创建）
2. 添加或更新packages字段，确保包含oss-cad-suite的版本信息，示例内容如下：

{
  "packages": {
    "oss-cad-suite": {
      "version": "0.0.8"
    }
  }
}

3. 保存文件后，重新执行apio install --list，此时应该显示oss-cad-suite已安装
4. 再次运行apio verify即可正常执行

另外，针对自动安装的平台匹配问题，也可以临时修改APIO的平台识别逻辑（不推荐，优先用上面的手动记录方法）：

• 找到APIO安装目录下的平台检测相关代码（通常在apio\managers\platform.py）
• 将Windows平台的识别结果从windows_x86改为windows_amd64，重新执行apio install oss-cad-suite即可自动下载正确的包

内容的提问来源于stack exchange，提问作者WheatleyOS