当前位置：首页 > news >正文

Python 应用上架 Microsoft Store 完整指南（2025）

news 2025/10/23 11:37:42

基于微软官方文档整理，涵盖从打包到发布的全流程

前期准备

所需工具

Python 3.8+ (已安装你的开发环境)
PyInstaller - 将 Python 代码打包成 Windows 可执行文件
MSIX Packaging Tool - 微软官方打包工具
Windows App Certification Kit (WACK) - 应用认证测试(包含在 Windows SDK 中)

账户要求

步骤一：安装 Windows SDK（包含 WACK）

重要提示：Windows App Certification Kit (WACK) 不是 Windows 系统自带的工具，需要通过安装 Windows SDK 获得。

为什么需要 Windows SDK?

Windows SDK 提供用于构建 Windows 应用程序的最新标头、库、元数据和工具。对于 Python 应用上架 Microsoft Store,你主要需要其中的 Windows App Certification Kit (WACK) 组件。

安装方式一：通过 Visual Studio Installer（推荐）

如果你已经安装了 Visual Studio:

打开 Visual Studio Installer
- 在开始菜单搜索 “Visual Studio Installer”
点击你的 Visual Studio 版本旁边的 “修改” 按钮
切换到 “单个组件” 标签
在 “SDK、库和框架” 部分找到:
- ✅ 勾选 “Windows 10 SDK (10.0.19041.0)” 或更新版本
- ✅ 勾选 “Windows 11 SDK (10.0.26100.0)”(推荐最新版)
点击右下角 “修改” 按钮开始安装
等待安装完成(约需下载 500MB-1GB)

安装后位置:

C:\Program Files (x86)\Windows Kits\10\App Certification Kit\

安装方式二：单独下载 Windows SDK（无需 Visual Studio）

如果你没有安装 Visual Studio:

步骤 1:下载 Windows SDK

访问官方下载页面:

Windows SDK 官方下载
点击页面上的 “下载安装程序” 按钮
下载 winsdksetup.exe(约 1.5MB 的在线安装器)

注意：Windows 8 之后,微软不再提供离线 ISO 安装包，只有在线安装器

步骤 2:运行安装程序

双击运行 winsdksetup.exe
选择安装位置:
- 默认路径:C:\Program Files (x86)\Windows Kits\10\
- 可以自定义到其他位置

选择要安装的组件:

推荐配置(仅安装必要组件,节省空间):

✅ Windows App Certification Kit    ← 这个必须选!
✅ Debugging Tools for Windows      ← 调试工具(可选)
❌ .NET Framework SDK               (Python 应用不需要)
❌ Windows Performance Toolkit      (性能分析,可选)
❌ Windows SDK for UWP Apps         (如果不开发 UWP,不需要)

点击 “安装” 开始下载和安装
等待安装完成(根据网速,可能需要 10-30 分钟)

验证安装

方法 1:通过开始菜单

按 Win 键打开开始菜单
搜索 “Windows App Cert Kit” 或 “Windows Kits”
如果能找到,说明安装成功

方法 2:通过文件路径

检查以下路径是否存在:

C:\Program Files (x86)\Windows Kits\10\App Certification Kit\appcertui.exe

方法 3:通过命令行

打开 PowerShell 或 CMD,运行:

"C:\Program Files (x86)\Windows Kits\10\App Certification Kit\appcert.exe" /?

如果显示帮助信息,说明安装成功。

常见问题

Q1: 安装过程中提示需要更新系统?

Windows SDK 需要通用 C 运行时更新。确保在安装 SDK 之前通过 Windows Update 安装最新的推荐更新和修补程序

解决方法:

设置 → Windows 更新 → 检查更新 → 安装所有更新后重启

Q2: 下载速度太慢怎么办?

在线安装器可能下载速度较慢,建议:

使用稳定的网络环境
避开高峰时段
或使用 Visual Studio Installer 安装(通常更快)

Q3: 可以只安装 WACK 吗?

可以!在安装向导中取消勾选其他组件,只保留:

✅ Windows App Certification Kit

这样可以节省大量磁盘空间。

Q4: 需要安装哪个版本的 SDK?

推荐安装最新版本的 Windows SDK(目前是 10.0.26100 for Windows 11)

对于 Microsoft Store 上架,任何 Windows 10 SDK 10.0.17763 或更高版本都可以。

SDK 版本对照表

SDK 版本	对应 Windows 版本	发布时间
10.0.26100	Windows 11 24H2	2024
10.0.22621	Windows 11 22H2	2022
10.0.19041	Windows 10 2004	2020
10.0.17763	Windows 10 1809	2018

建议:下载最新版本以获得最佳兼容性和功能。

磁盘空间要求

安装选项	磁盘空间
完整安装(所有组件)	~3-5 GB
仅 WACK + 调试工具	~500 MB
最小安装(仅 WACK)	~200 MB

步骤二：用 PyInstaller 打包 Python 应用

安装 PyInstaller

pip install pyinstaller

打包应用

PyInstaller 会分析你的代码,找出所有需要的模块和库,然后将它们连同 Python 解释器一起收集到一个文件夹或单个可执行文件中

推荐命令(onedir 模式):

pyinstaller -D -w --icon=icon.ico --name=MyApp main.py

参数说明:

-D (或 --onedir):生成文件夹模式,包含 exe 和所有依赖(推荐)
-w (或 --windowed):无控制台窗口(GUI 应用必须使用)
--icon:指定应用图标(.ico 格式)
--name:指定输出应用名称

不推荐使用 -F (onefile 模式)的原因:

Windows Defender 会将使用 onefile 模式创建的 GUI 应用标记为恶意软件并移除
启动速度慢(需要先解压到临时目录)
不适合 MSIX 打包

验证打包结果

打包完成后,检查 dist/MyApp/ 文件夹:

dist/
└── MyApp/├── MyApp.exe          # 主程序├── python3x.dll       # Python 运行时└── _internal/         # 依赖库和资源

运行测试:

cd dist/MyApp
MyApp.exe

确保应用能正常启动和运行。

步骤三：使用 MSIX Packaging Tool 创建 MSIX 包

什么是 MSIX?

MSIX 是 Windows 应用包格式,为所有 Windows 应用提供现代化的打包体验。它保留了现有应用包的功能,同时为 Win32、WPF 和 Windows Forms 应用启用了新的现代打包和部署功能

安装 MSIX Packaging Tool

从 Microsoft Store 安装 MSIX Packaging Tool

或使用 WinGet:

winget install "MSIX Packaging Tool"

创建 MSIX 包的正确方法

重要澄清:

MSIX Packaging Tool 作为重新打包工具,可以让你在没有安装程序的情况下创建包。它会在安装应用或修改操作系统时做两次快照(安装前和安装后),比较快照后生成 MSIX 包

对于 PyInstaller 打包的应用,有两种方式:

方式 A:不使用安装程序(推荐 Python 应用)

打开 MSIX Packaging Tool
选择 “Application package”
选择 “Create package on this computer”
在 “Select installer” 页面:
- 点击 “Browse”
- 不选择安装程序,而是:
  - 手动指定你的 MyApp.exe 路径
  - 或者在下一步手动复制整个 dist/MyApp/ 文件夹内容

Package information 页面填写:

Package name: com.yourname.myapp
Package display name: My App
Publisher display name: Your Name
Publisher: CN=Your Name
Version: 1.0.0.0

Installation 页面:
- 手动将 dist/MyApp/ 文件夹的所有内容复制到指定安装位置
- 或运行你的 exe 测试功能
完成后保存 MSIX 包

方式 B:使用现有安装程序

如果你已经使用其他工具(如 Advanced Installer)创建了安装程序,可以直接在 MSIX Packaging Tool 中选择该安装程序,工具会自动提取文件

2.4 配置包清单(重要)

每个 MSIX 包都必须进行数字签名,这是强制要求,没有例外

在打包过程中,确保:

✅ 选择签名证书(自签名或购买的证书)
✅ 填写完整的包信息
✅ 如果上架 Store,勾选 “Enforce Microsoft Store versioning requirements”

步骤四：测试和签名

运行 Windows App Certification Kit (WACK)

使用 Windows App Certification Kit 测试你的 MSIX 包

运行测试:

在开始菜单搜索 “Windows App Cert Kit”
选择你的 MSIX 文件
运行所有测试
确保全部通过

或命令行方式:

appcert.exe test -appxpackagepath "C:\path\to\MyApp.msix"

本地安装测试

# 安装 MSIX 包
Add-AppxPackage MyApp.msix# 测试应用功能# 卸载测试
Remove-AppxPackage -Package "YourPackageName"

签名要求

所有 MSIX 包必须使用 SHA-256 代码签名证书进行数字签名。如果内部部署,可以使用自签名证书(需预先安装到所有目标机器上)。Microsoft Store 上的所有包都由微软证书签名。

上架 Store 不需要你自己的证书，微软会重新签名。

步骤五：注册开发者账户

创建 Microsoft Store 开发者账户

必须从 storedeveloper.microsoft.com 开始注册流程。在注册过程中需要验证身份以防止欺诈和冒充，保护客户安全

注册步骤:

访问 https://developer.microsoft.com/store/register
使用 Microsoft 账户登录
选择账户类型:
- 个人账户:免费（部分地区）或 $19
- 公司账户:$99
填写个人/公司信息
完成身份验证
同意开发者协议
等待账户审核(通常 24-48 小时)

访问 Partner Center

访问地址 https://partner.microsoft.com/dashboard

步骤六：提交应用到 Microsoft Store

创建新应用

在 Partner Center 点击 “+ New product” → “App”
保留应用名称:
- 输入应用名称
- 检查可用性
- 点击"Reserve product name"
名称保留成功后,进入应用配置页面

填写应用提交信息

A. 定价和可用性 (Pricing and availability)

价格: 选择免费或设置价格
市场: 选择发布地区
可见性: 公开、私密或仅限特定用户
发布日期: 立即发布或定时发布

B. 属性 (Properties)

类别: 选择应用类别(生产力、娱乐等)
子类别: 进一步细化分类

系统要求:

最低版本: Windows 10 version 1809 或更高
推荐版本: Windows 11

年龄分级: 填写 IARC 问卷

C. 程序包 (Packages)

上传 MSIX 包:

点击"Browse files"
上传你的 .msix 文件
系统会自动验证包
确保通过所有检查

注意:

单个包最大 25GB
支持多个架构(x86、x64、ARM64)
版本号必须递增

D. Store 列表 (Store listings)

必填信息:

描述:
- 简洁明了的应用介绍(最少 200 字符)
- 突出主要功能
- 避免营销夸大
截图(必需):
- 至少 1 张,最多 10 张
- 推荐分辨率:1920x1080
- 支持格式:PNG, JPEG
应用图标:
- 多种尺寸:400x400、150x150、71x71 等
- PNG 格式,透明背景
其他可选信息:
- 宣传图片
- 预告片视频
- 附加说明
- 版权信息
- 许可条款链接
- 隐私政策链接(如果收集数据则必需)

提交审核

确认所有必填项已完成
点击页面底部的 “Submit for certification”
等待审核(通常 24-72 小时)

审核状态跟踪

在 Partner Center 可以看到:

Preparing for certification: 准备中
In certification: 审核中
In the Store: 已上架
Failed: 审核失败(查看失败原因并修改)

常见问题与注意事项

Q1: 用户需要安装 Python 吗?

**不需要。**PyInstaller 会收集包括活动 Python 解释器在内的所有文件副本

Q2: 打包后文件很大怎么办?

Python 应用打包后通常 20-100MB 是正常的
可以使用 UPX 压缩(PyInstaller 支持 --upx-dir 参数)
移除不必要的依赖库

Q3: 杀毒软件误报怎么办?

如果使用 onefile 模式,Windows Defender 可能会将其标记为恶意软件。解决方法是使用 onedir 模式或对可执行文件进行数字签名

Q4: 审核失败的常见原因

应用崩溃或无法启动
未通过 WACK 测试
缺少隐私政策(如果收集用户数据)
截图或描述不符合规范
违反 Store 政策

Q5: 如何更新已上架的应用?

修改代码后重新打包
版本号必须递增(如 1.0.0.0 → 1.0.1.0)
在 Partner Center 创建新的提交
上传新的 MSIX 包
重新提交审核

Q6: MSIX 包里到底装的是什么?

最终的 .msix 文件包含应用程序本身(可执行文件、DLL、资源文件等),不包含原始的安装包

完整流程总结

Python 代码↓
【PyInstaller 打包】(-D 模式)↓
dist/MyApp/ 文件夹(exe + 依赖)↓
【MSIX Packaging Tool】↓
MyApp.msix 包↓
【WACK 测试】↓
【Partner Center 提交】↓
Microsoft Store 上架