Fastlane上传元数据与截图后未在App Store Connect显示求助

我是Fastlane新手，想用它更新Mac应用的本地化元数据与截图。执行流程显示成功，但元数据和截图未在App Store Connect中显示，且原有截图被删除，求解决思路。

执行日志 #

$ fastlane mac metadata
[✔] 🚀 
[12:51:13]: fastlane detected a Gemfile in the current directory
[12:51:13]: However, it seems like you didn't use `bundle exec`
[12:51:13]: To launch fastlane faster, please use
[12:51:13]: 
[12:51:13]: $ bundle exec fastlane mac metadata
[12:51:13]: 
[12:51:13]: Get started using a Gemfile for fastlane https://docs.fastlane.tools/getting-started/ios/setup/#use-a-gemfile
[12:51:13]: Driving the lane 'mac metadata' 🚀
[12:51:13]: ---------------------------------------
[12:51:13]: --- Step: app_store_connect_api_key ---
[12:51:13]: ---------------------------------------
[12:51:13]: ---------------------
[12:51:13]: --- Step: deliver ---
[12:51:13]: ---------------------
[12:51:13]: Successfully loaded '/Volumes/Projekte/Translate/Sources/Visual Studio/fastlane/Deliverfile' 📄

+----------------------------------------------------------------------+
|            Detected Values from './fastlane/Deliverfile'             |
+--------------------------------+-------------------------------------+
| app_identifier                 | xxxx.xxxxxxxx.xxxxxxxxxxxxxxxxxx.xx |
| username                       | xxxxxx@xxxxxxx.xx                   |
| platform                       | osx                                 |
| verify_only                    | false                               |
| version_check_wait_retry_limit | 1                                   |
| skip_app_version_update        | true                                |
| force                          | true                                |
| sync_screenshots               | false                               |
| overwrite_screenshots          | false                               |
| skip_binary_upload             | true                                |
| submit_for_review              | false                               |
| automatic_release              | false                               |
+--------------------------------+-------------------------------------+

[12:51:13]: Creating authorization token for App Store Connect API

+----------------------------------------------------------------------------+
|                          deliver 2.225.0 Summary                           |
+--------------------------------------+-------------------------------------+
| metadata_path                        | ./metadata                          |
| screenshots_path                     | ./screenshots                       |
| api_key                              | ********                            |
| run_precheck_before_submit           | false                               |
| username                             | xxxxxx@xxxxxxx.xx                   |
| app_identifier                       | xxxx.xxxxxxxx.xxxxxxxxxxxxxxxxxx.xx |
| platform                             | osx                                 |
| edit_live                            | false                               |
| use_live_version                     | false                               |
| skip_binary_upload                   | true                                |
| skip_screenshots                     | false                               |
| skip_metadata                        | false                               |
| skip_app_version_update              | true                                |
| force                                | true                                |
| overwrite_screenshots                | false                               |
| screenshot_processing_timeout        | 3600                                |
| sync_screenshots                     | false                               |
| submit_for_review                    | false                               |
| verify_only                          | false                               |
| reject_if_possible                   | false                               |
| version_check_wait_retry_limit       | 1                                   |
| automatic_release                    | false                               |
| phased_release                       | false                               |
| reset_ratings                        | false                               |
| precheck_default_rule_level          | warn                                |
| ignore_language_directory_validation | false                               |
| precheck_include_in_app_purchases    | true                                |
+--------------------------------------+-------------------------------------+

[12:51:17]: No changes to localized App Info detected. Skipping upload.
[12:51:18]: Will begin uploading metadata for '0.9.1' on App Store Connect
[12:51:18]: Uploading metadata to App Store Connect for version
[12:51:25]: Will begin uploading snapshots for '0.9.1' on App Store Connect
[12:51:25]: Starting with the upload of screenshots...
[✔] Waiting for all the screenshots to finish being processed... 
[12:51:26]: Successfully uploaded all screenshots
[✔] Sorting screenshots uploaded... 
[12:51:27]: Successfully uploaded screenshots to App Store Connect

+------------------------------------------------+
|                fastlane summary                |
+------+---------------------------+-------------+
| Step | Action                    | Time (in s) |
+------+---------------------------+-------------+
| 1    | app_store_connect_api_key | 0           |
| 2    | deliver                   | 13          |
+------+---------------------------+-------------+

[12:51:27]: fastlane.tools finished successfully 🎉

Deliverfile配置 #

app_identifier "xxxx.xxxxxxxx.xxxxxxxxxxxxxxxxxx.xx"
username "xxxxxx@xxxxxxx.xx" 

platform "osx"
verify_only false
version_check_wait_retry_limit 1
skip_app_version_update true
force true
sync_screenshots false
overwrite_screenshots true
skip_binary_upload true
submit_for_review false
automatic_release false

Fastfile配置 #

platform :mac do
  desc "Upload metadata and screenshots"
  lane :metadata do
    api_key = app_store_connect_api_key(
      key_id: 'xxxxxxxxxx',
      issuer_id: 'xxxxxxxx-xxxx-xxxx-xxxx-xxxxxxxxxxxx',
      key_filepath: '/Volumes/Daten/Zertifikate und API-Schlüssel (Apple)/App Store Connect.p8'
    )
    deliver(
      metadata_path: "./metadata",
      screenshots_path: "./screenshots",
      api_key: api_key,
      run_precheck_before_submit: false
    )
  end
end

解决思路 #

• 核对版本匹配：确认App Store Connect中存在0.9.1版本，且该版本处于未提交、未发布的可编辑状态。若版本已提交审核或发布，Fastlane无法修改，需创建新版本后再执行上传。
• 检查截图目录结构：确保screenshots目录下的语言子目录（如zh-Hans）中，截图文件名符合Mac平台尺寸规范（例如1280x800.png），Fastlane依赖文件名识别对应设备类型，格式错误会导致上传后不显示。
• 排查配置冲突：日志中显示overwrite_screenshots为false，但Deliverfile中设置为true，可能存在配置优先级冲突。建议在Fastlane的deliver参数中显式指定overwrite_screenshots: true，确保配置生效；同时sync_screenshots: false会保留远程未删除的截图，若原有截图被删，需检查是否本地未包含对应截图且配置逻辑异常。
• 验证元数据差异：日志提示No changes to localized App Info detected，需检查./metadata目录下的语言子文件（如description.txt、release_notes.txt）是否有实际修改，且内容与App Store Connect远程版本存在差异。
• 确认API权限：检查App Store Connect的API Key是否拥有App Manager或Developer权限，权限不足可能导致上传成功但内容不显示。
• 等待缓存刷新：App Store Connect存在数据延迟，上传成功后需等待10-30分钟再查看内容是否显示。
• 开启详细日志排查：执行bundle exec fastlane mac metadata --verbose获取更详细的上传日志，查看是否有隐藏的警告或错误（如元数据字段不符合规范、截图尺寸不匹配等）。

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