执行python -m briefcase dev触发AttributeError错误求助

执行python -m briefcase dev时触发如下错误：

Traceback (most recent call last):
  File "C:\Program Files\Python38\lib\runpy.py", line 193, in _run_module_as_main
    return _run_code(code, main_globals, None,
  File "C:\Program Files\Python38\lib\runpy.py", line 86, in _run_code
    exec(code, run_globals)
  File "C:\Users\mpgam\AppData\Roaming\Python\Python38\site-packages\briefcase\__main__.py", line 66, in <module>
    sys.exit(main())  # pragma: no cover
  File "C:\Users\mpgam\AppData\Roaming\Python\Python38\site-packages\briefcase\__main__.py", line 25, in main
    command.parse_config(
  File "C:\Users\mpgam\AppData\Roaming\Python\Python38\site-packages\briefcase\commands\base.py", line 831, in parse_config
    global_config, app_configs = parse_config(
  File "C:\Users\mpgam\AppData\Roaming\Python\Python38\site-packages\briefcase\config.py", line 483, in parse_config
    for app_name, app_data in all_apps.items():
AttributeError: 'str' object has no attribute 'items'

已确认briefcase.toml和pyproject.toml存在，且尝试删除重建后问题依旧。

问题原因与修复步骤 #

该错误核心是配置文件中apps字段被解析成字符串，而非预期的字典结构，导致Briefcase无法遍历读取应用配置。按以下步骤排查：

• 检查briefcase.toml的[apps]区块格式：
  确保[apps]下是键值对形式的应用配置，而非直接赋值字符串。正确示例：

  [apps]
  my-app = {
      app_name = "My App",
      formal_name = "My Application",
      description = "Test application",
      version = "0.1.0",
      author = "Your Name",
      bundle = "com.yourdomain.myapp",
      sources = ["src/my_app"]
  }
  

  禁止错误写法：

  # 错误：apps被设为字符串
  apps = "my-app"
  

• 检查pyproject.toml中的Briefcase配置：
  如果用pyproject.toml管理配置，需确保应用配置在[tool.briefcase.apps]下以子区块定义，正确示例：

  [tool.briefcase.apps.my-app]
  app_name = "My App"
  formal_name = "My Application"
  description = "Test application"
  version = "0.1.0"
  author = "Your Name"
  bundle = "com.yourdomain.myapp"
  sources = ["src/my_app"]
  

  不要将tool.briefcase.apps设为字符串值。

• 验证配置文件语法：
  TOML对语法要求严格，检查是否存在括号不匹配、逗号遗漏、引号未闭合等问题，这些会导致配置解析异常。

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