docs: 新增商店列表、隐私政策、检查清单等文档 build: 更新.gitignore移除package-lock.json style: 更新version.ts中的生成时间
12 KiB
扩展商店发布指南 / Extension Store Submission Guide
本文档提供Chrome Web Store和Microsoft Edge Add-ons的详细发布流程。
目录
准备工作
1. 构建生产版本
# 确保所有测试通过
npm test
npm run typecheck
npm run lint
# 构建生产版本
npm run build
# 验证构建结果
ls -la dist/
2. 打包扩展
# 进入dist目录
cd dist
# 创建zip包
zip -r ../cloud-drive-renamer-v0.1.0.zip .
# 返回项目根目录
cd ..
3. 准备视觉资产
确保以下文件准备就绪:
- 图标:
public/icons/icon128.png(128x128) - 截图:
screenshots/store/cdr-01.png(1280x800 或类似) - 截图:
screenshots/store/cdr-02.png - 截图:
screenshots/store/cdr-03.png
4. 准备文档
- Chrome商店列表:
store-assets/chrome-web-store-listing.md - Edge商店列表:
store-assets/edge-addons-listing.md - 隐私政策:
store-assets/PRIVACY_POLICY.md
Chrome Web Store发布流程
第一步:创建开发者账号
- 访问 Chrome Web Store Developer Dashboard
- 使用Google账号登录
- 支付一次性注册费用(5美元)
- 完成开发者账号注册
第二步:创建新商品
- 在开发者控制台,点击 "New Item"
- 上传扩展包
cloud-drive-renamer-v0.1.0.zip - 等待上传完成
第三步:填写商店列表信息
基本信息
-
Product name(产品名称)
云盘批量重命名工具 -
Summary(简短描述)
强大的批量重命名工具,支持夸克网盘文件批量重命名(阿里云盘和百度网盘开发中) -
Category(分类)
- Primary:
Productivity - Secondary: 可选
- Primary:
-
Language(语言)
- 主要语言:
中文(简体) - 支持的语言:
中文(简体)、English、中文(繁体)
- 主要语言:
详细描述
从 store-assets/chrome-web-store-listing.md 复制"详细描述"部分的中文内容。
图形资产
-
Icon(图标)
- 上传:
public/icons/icon128.png - 尺寸: 128x128 pixels
- 上传:
-
Screenshots(截图)
- 上传以下文件(按顺序):
screenshots/store/cdr-01.png- "直观的批量重命名界面"screenshots/store/cdr-02.png- "实时预览功能"screenshots/store/cdr-03.png- "智能执行进度追踪"
- 上传以下文件(按顺序):
-
Promotional Images(宣传图片,可选)
- Small tile: 440x280 (如果有)
- Large tile: 920x680 (如果有)
- Marquee: 1400x560 (如果有)
隐私设置
-
Privacy Policy(隐私政策)
- 上传
store-assets/PRIVACY_POLICY.md到GitHub - 填写URL:
https://github.com/lhly/cloud-drive-renamer/blob/main/store-assets/PRIVACY_POLICY.md
- 上传
-
Permissions(权限说明)
- 填写从
store-assets/chrome-web-store-listing.md复制的"权限用途说明"
- 填写从
-
Data Usage(数据使用)
- 选择: "This item does not collect user data"
分发设置
-
Visibility(可见性)
- 选择: "Public"(公开)
-
Regions(地区)
- 选择: "All regions"(所有地区)
-
Pricing(定价)
- 选择: "Free"(免费)
第四步:提交审核
- 检查所有必填项已完成
- 点击 "Submit for review"
- 确认提交
第五步:等待审核
- 审核时间:通常1-3个工作日
- 审核状态可在开发者控制台查看
- 如有问题,会收到邮件通知
Microsoft Edge Add-ons发布流程
第一步:创建开发者账号
- 访问 Microsoft Partner Center
- 使用Microsoft账号登录(或创建新账号)
- 完成开发者账号注册(免费)
第二步:进入Edge Add-ons管理
- 在Partner Center,选择 "Office and SharePoint Add-ins"
- 或直接访问: Edge Add-ons Manager
第三步:创建新扩展提交
- 点击 "Create new extension"
- 上传扩展包
cloud-drive-renamer-v0.1.0.zip - 等待上传和自动验证完成
第四步:填写商店列表信息
Package(扩展包)
- 已在第三步上传
- 确认包验证通过(无错误或警告)
Properties(属性)
-
Category(分类)
- 选择:
Productivity
- 选择:
-
Additional categories(附加分类,可选)
- 可以不填或选择相关分类
-
Search terms(搜索词)
文件重命名, 批量重命名, 云盘, Quark Drive, Rename, Batch Operations -
Logo(标志)
- 上传:
public/icons/icon128.png - 尺寸: 128x128 pixels
- 上传:
Listings(商店列表)
需要为每种支持的语言创建列表:
中文(简体)列表
-
Language(语言):
Chinese (Simplified, China) -
Extension name(扩展名称)
云盘批量重命名工具 -
Short description(简短描述)
强大的批量重命名工具,支持夸克网盘文件批量重命名(阿里云盘和百度网盘开发中) -
Long description(详细描述)
- 从
store-assets/edge-addons-listing.md复制中文版本的"完整描述"
- 从
-
Screenshots(截图)
- 上传以下文件并添加说明:
screenshots/store/cdr-01.png- 说明: "直观的批量重命名界面 - 支持多种规则配置"
screenshots/store/cdr-02.png- 说明: "实时预览功能 - 所见即所得的重命名效果"
screenshots/store/cdr-03.png- 说明: "智能执行进度追踪 - 批量操作一目了然"
- 上传以下文件并添加说明:
English列表
重复上述步骤,使用英文内容(从 store-assets/edge-addons-listing.md 获取)
Availability(可用性)
-
Markets(市场)
- 选择: "All markets"(所有市场)
-
Visibility(可见性)
- 选择: "Public"(公开)
Privacy(隐私)
-
Privacy policy URL(隐私政策URL)
https://github.com/lhly/cloud-drive-renamer/blob/main/store-assets/PRIVACY_POLICY.md -
Website(网站)
https://github.com/lhly/cloud-drive-renamer -
Support contact(支持联系)
- Email:
lhlyzh@qq.com
- Email:
-
Permissions justification(权限说明)
- 从
store-assets/edge-addons-listing.md复制"数据使用说明"
- 从
第五步:提交审核
- 检查所有部分已完成
- 点击 "Submit"
- 确认提交
第六步:等待审核
- 审核时间:通常3-7个工作日
- 审核状态可在Partner Center查看
- 如有问题,会收到邮件通知
发布后维护
监控审核状态
Chrome Web Store
- 访问: Chrome Web Store Developer Dashboard
- 查看扩展状态
- 处理审核反馈(如有)
Microsoft Edge Add-ons
- 访问: Partner Center
- 查看提交状态
- 处理审核反馈(如有)
发布成功后
-
记录商店链接
- Chrome:
https://chrome.google.com/webstore/detail/[extension-id] - Edge:
https://microsoftedge.microsoft.com/addons/detail/[extension-id]
- Chrome:
-
更新README.md
- 添加商店徽章
- 添加安装链接
-
社交媒体推广
- 发布公告
- 分享商店链接
处理审核被拒
如果审核被拒,常见原因和解决方案:
常见拒绝原因
-
权限过度
- 检查manifest.json中的权限
- 确保每个权限都有明确的说明
-
功能不工作
- 在Chrome/Edge中重新测试
- 确保所有功能正常
-
描述不清晰
- 改进商店列表描述
- 添加更多截图说明
-
隐私政策问题
- 确保隐私政策URL可访问
- 检查隐私政策内容完整性
-
违反内容政策
- 检查是否符合商店政策
- 移除可能违规的内容
修复和重新提交
- 根据反馈修改相应内容
- 重新构建扩展包(如果修改了代码)
- 更新商店列表信息(如果修改了描述)
- 重新提交审核
版本更新流程
当发布新版本时:
-
更新版本号
# 更新package.json和manifest.json中的版本号 npm version patch # 或 minor, major npm run sync:version -
构建和打包
npm run build cd dist zip -r ../cloud-drive-renamer-v[新版本号].zip . cd .. -
上传新版本
- Chrome: 在开发者控制台上传新包
- Edge: 在Partner Center上传新包
-
更新商店列表(如有变化)
- 更新描述
- 添加新截图
- 更新功能列表
-
提供更新日志
## 版本 0.2.0 更新内容 - 新增阿里云盘支持 - 优化重命名速度 - 修复若干已知问题
常见问题
Q: 审核需要多长时间?
A:
- Chrome Web Store: 通常1-3个工作日
- Microsoft Edge Add-ons: 通常3-7个工作日
- 首次提交可能需要更长时间
Q: 如何加快审核速度?
A:
- 确保所有信息准确完整
- 提供清晰的截图和描述
- 隐私政策详细且易于访问
- 扩展功能完全正常工作
- 遵守所有商店政策
Q: 可以同时发布到两个商店吗?
A: 是的,可以同时提交到Chrome和Edge商店。两者审核独立进行。
Q: 发布后可以修改商店列表吗?
A: 可以。修改描述、截图等无需重新审核。但修改扩展代码需要提交新版本并重新审核。
Q: 如何处理用户反馈?
A:
- 及时回复商店评论
- 在GitHub Issues处理技术问题
- 通过邮件回复用户询问
- 定期发布更新解决问题
Q: 需要支付费用吗?
A:
- Chrome Web Store: 一次性5美元注册费
- Microsoft Edge Add-ons: 免费
Q: 扩展被下架怎么办?
A:
- 查看下架原因通知邮件
- 修复违规内容
- 联系商店支持团队
- 申请重新审核
联系支持
Chrome Web Store
- 支持中心: https://support.google.com/chrome_webstore/
- 开发者论坛: https://groups.google.com/a/chromium.org/g/chromium-extensions
Microsoft Edge Add-ons
- 支持中心: https://docs.microsoft.com/microsoft-edge/extensions-chromium/
- 开发者论坛: https://techcommunity.microsoft.com/
项目支持
- GitHub Issues: https://github.com/lhly/cloud-drive-renamer/issues
- 邮箱: lhlyzh@qq.com
检查清单
发布前检查
- 代码通过所有测试
- TypeScript编译无错误
- ESLint检查通过
- 版本号已更新
- 构建生产版本成功
- 扩展包已创建
- 在Chrome中测试安装和功能
- 在Edge中测试安装和功能
- 所有截图准备就绪
- 图标符合要求
- 商店列表文本已准备
- 隐私政策已上传到可访问的URL
- 开发者账号已注册
Chrome提交检查
- 扩展包已上传
- 产品名称已填写
- 简短描述已填写
- 详细描述已填写
- 分类已选择
- 图标已上传
- 至少1张截图已上传
- 隐私政策URL已填写
- 权限说明已填写
- 可见性设置为Public
- 地区设置为All regions
- 定价设置为Free
Edge提交检查
- 扩展包已上传并验证通过
- 分类已选择
- Logo已上传
- 中文列表已完成
- 英文列表已完成
- 截图及说明已上传
- 隐私政策URL已填写
- 支持联系信息已填写
- 权限说明已填写
- 市场设置为All markets
- 可见性设置为Public
祝发布顺利! 🚀