Windows系统下使用Apple Transporter上传iOS应用时，如何正确生成metadata.xml文件？

很多开发者首次在Windows上用Apple Transporter CLI上传iOS应用时，都会碰到你这种1019错误——我之前踩过一模一样的坑！大概率是metadata.xml的内容不全或者格式不符合首次上传的要求，毕竟官方对首次提交的应用元数据要求比更新应用严格得多，而且你也提到lookup模式不支持，只能手动写全所有必填字段。

你当前metadata.xml的核心问题 #

你现在的xml只包含了IPA文件的资产信息，但首次上传的应用必须补充完整的应用基础元数据节点——缺少这些节点的话，Transporter的验证流程会直接返回1019的通用错误，根本不会深入验证其他内容。

适合首次上传的完整metadata.xml模板 #

我当时踩坑后，查了很多资料，整理出一个符合要求的完整模板，你可以直接参考修改：

<?xml version="1.0" encoding="UTF-8"?>
<package version="software5.4" xmlns="http://apple.com/itunes/importer">
  <!-- 首次上传必须的基础应用元数据，缺了这个必报1019 -->
  <software>
    <apple_id>1234567890</apple_id> <!-- 替换成App Store Connect里的应用数字ID -->
    <vendor_id>ABCDE12345</vendor_id> <!-- 替换成你的开发者账号Vendor ID -->
    <bundle_identifier>com.example.x</bundle_identifier>
    <bundle_short_version_string>1.1.9</bundle_short_version_string>
    <bundle_version>1.1.9</bundle_version>
    <app_platform>ios</app_platform>
    <name>你的应用正式名称</name>
    <locale>zh-CN</locale> <!-- 对应App Store Connect设置的默认语言，比如en-US -->
    <description>你的应用功能描述，要和App Store Connect里的一致</description>
    <software_support_url>https://your-app-support.com</software_support_url>
    <privacy_policy_url>https://your-app-privacy.com</privacy_policy_url>
    <primary_category>
      <category>Utilities</category> <!-- 选App Store官方支持的分类，比如Games/Action -->
    </primary_category>
  </software>

  <!-- IPA资产信息，这里的字段要和IPA本身完全匹配 -->
  <software_assets apple_id="1234567890" bundle_short_version_string="1.1.9" bundle_version="1.1.9" bundle_identifier="com.example.x" app_platform="ios">
    <asset type="bundle">
      <data_file>
        <file_name>MyApp.ipa</file_name>
        <checksum type="md5">实际的MD5值</checksum>
        <size>IPA文件的字节大小</size>
      </data_file>
    </asset>
  </software_assets>
</package>

关键细节一定要注意 #

1. 字段必须完全匹配App Store Connect：
   • apple_id：去App Store Connect应用详情页的“通用”->“App信息”里找应用ID（是一串数字）
   • vendor_id：在App Store Connect的“用户和访问”->“密钥”页面底部可以看到
   • 分类、语言、版本号这些，必须和你在App Store Connect里预先设置的完全一致，不能有任何偏差
2. MD5和文件大小要准确：
   别随便填占位符，Windows上可以用命令行快速获取：
   • 计算MD5：certutil -hashfile MyApp.ipa MD5，把输出的字符串去掉空格就是checksum值
   • 文件大小：右键IPA文件→属性→常规里的“大小（字节）”，直接填数字就行
3. XML格式要严谨：
   不要保留任何转义字符（比如你之前写的<MY_APPLE_ID>要改成实际数字），所有标签必须正确闭合，不能有语法错误

验证和上传的正确姿势 #

修改完xml后，用带账号信息的命令验证（Windows上必须用专用密码，不能用普通Apple ID密码）：

iTMSTransporter -m verify -f "C:\你的路径\MyApp.itmsp" -u "你的App Store Connect账号邮箱" -p "你的专用密码"

如果验证通过，再用上传命令：

iTMSTransporter -m upload -f "C:\你的路径\MyApp.itmsp" -u "你的账号邮箱" -p "专用密码"

万一还是1019怎么办？ #

如果xml没问题但还是报错，大概率是Apple服务器的临时故障，你可以等10-15分钟再试，或者换个网络环境（比如关掉代理、用手机热点），因为Windows的网络设置有时候会干扰Transporter和Apple服务器的连接。

内容来源于stack exchange