Skip to content

Latest commit

 

History

History
387 lines (284 loc) · 7.94 KB

File metadata and controls

387 lines (284 loc) · 7.94 KB

Chrome插件打包与发布指南

📦 打包插件

方法1:打包为.crx文件(本地分享)

步骤:

  1. 打开扩展程序页面

    chrome://extensions/
    
  2. 确保插件已加载且正常工作

    • 插件状态显示"已启用"
    • 测试所有功能正常
  3. 点击"打包扩展程序"

    • 在页面顶部找到"打包扩展程序"按钮
    • 如果没有此按钮,确认已开启开发者模式
  4. 选择扩展程序根目录

    扩展程序根目录: /path/to/chrome-extension
    私有密钥文件: (首次留空)
    
  5. 生成文件 系统会生成两个文件:

    • chrome-extension.crx - 插件安装包
    • chrome-extension.pem - 私钥文件(重要!请妥善保存

⚠️ 重要提示:

  • .pem 文件是更新插件时需要的密钥
  • 必须保密,不要分享或提交到Git
  • 丢失后无法发布更新版本

方法2:打包为.zip文件(上架Chrome应用商店)

步骤:

  1. 准备文件 确保 chrome-extension 文件夹包含所有必需文件:

    chrome-extension/
    ├── manifest.json
    ├── background/
    ├── content/
    ├── popup/
    ├── icons/
    └── README.md
    
  2. 清理不必要的文件 删除以下文件:

    # 进入插件目录
    cd chrome-extension
    
    # 删除临时文件
    rm -rf .DS_Store
    rm -rf __MACOSX
    rm -rf .git
    rm -rf node_modules
  3. 创建ZIP压缩包

    Windows:

    • 右键点击 chrome-extension 文件夹
    • 选择"发送到" → "压缩(zipped)文件夹"
    • 重命名为 xhs-comment-scraper-v2.0.0.zip

    Mac:

    • 右键点击 chrome-extension 文件夹
    • 选择"压缩"
    • 重命名为 xhs-comment-scraper-v2.0.0.zip

    命令行:

    cd "/path/to/parent/folder"
    zip -r xhs-comment-scraper-v2.0.0.zip chrome-extension -x "*.DS_Store" -x "*__MACOSX*"
  4. 验证ZIP包 解压后应该直接看到文件,而不是文件夹套文件夹:

    ✅ 正确结构:
    xhs-comment-scraper.zip
    ├── manifest.json
    ├── background/
    └── ...
    
    ❌ 错误结构:
    xhs-comment-scraper.zip
    └── chrome-extension/
        ├── manifest.json
        └── ...
    

🌐 发布到Chrome应用商店

前提条件

  • ✅ Google开发者账号(一次性费用$5 USD)
  • ✅ 完整的插件ZIP包
  • ✅ 宣传图片和截图
  • ✅ 隐私政策页面(如果收集用户数据)

注册开发者账号

  1. 访问Chrome网上应用店开发者中心

    https://chrome.google.com/webstore/devconsole
    
  2. 支付注册费

    • 费用:$5 USD(一次性)
    • 支付方式:信用卡
  3. 完成账号验证

    • 邮箱验证
    • 身份信息(可选)

上传插件

  1. 点击"新建商品"

  2. 上传ZIP文件

    • 拖拽或选择之前打包的ZIP文件
    • 等待验证完成
  3. 填写商品信息

    商店详情:

    商品名称: Star Seeker
    简短说明: 一键抓取小红书帖子评论并导出CSV
    详细说明: [复制README.md中的功能介绍]
    类别: 生产工具 / 开发者工具
    语言: 中文(简体)
    
  4. 上传宣传素材

    必需素材:

    • 小图标 (128x128): icon-128.png
    • 宣传图片 (440x280): 需要单独制作
    • 截图 (1280x800 或 640x400): 至少1张,最多5张

    可选素材:

    • 宣传视频 (YouTube链接)
    • 品牌推广区块图片 (marquee)
  5. 隐私设置

    是否收集用户数据?

    • 选择"否"(我们的插件不收集用户数据)

    如果选择"是",需要提供:

    • 隐私政策URL
    • 数据使用说明
  6. 分发设置

    可见性: 公开/不公开
    区域: 中国大陆(或全球)
    定价: 免费
    

提交审核

  1. 预览商品页面

    • 检查所有信息是否正确
    • 测试所有链接
  2. 点击"提交审核"

  3. 等待审核

    • 审核时间:通常1-3个工作日
    • 审核期间可以撤回修改
  4. 审核通过后

    • 插件会自动上架
    • 用户可以搜索并安装

🔄 更新已发布的插件

更新流程

  1. 修改代码

    • 更新功能或修复bug
  2. 更新版本号 编辑 manifest.json:

    {
      "version": "2.0.1"  // 从 2.0.0 改为 2.0.1
    }
  3. 重新打包

    • 使用相同的 .pem 私钥文件
    • 生成新的 .crx 文件
  4. 上传新版本到应用商店

    • 登录开发者中心
    • 选择已发布的商品
    • 点击"上传已更新的zip文件"
    • 提交审核
  5. 等待审核通过

    • 审核时间通常较短
    • 通过后自动推送给所有用户

版本号规范

遵循语义化版本(Semantic Versioning):

主版本号.次版本号.修订号
MAJOR.MINOR.PATCH
  • 主版本号(MAJOR): 重大功能变更,不向下兼容

    • 1.0.02.0.0
  • 次版本号(MINOR): 新增功能,向下兼容

    • 2.0.02.1.0
  • 修订号(PATCH): Bug修复,向下兼容

    • 2.0.02.0.1

📸 准备宣传素材

1. 截图制作

推荐工具:

  • Snipaste (Windows/Mac)
  • ShareX (Windows)
  • 系统截图工具

截图内容建议:

  1. 插件弹窗界面展示
  2. 页面悬浮工具栏
  3. 抓取过程动图
  4. 导出的CSV文件预览
  5. 数据统计图表

尺寸要求:

  • 标准: 1280x800 或 640x400
  • 格式: PNG或JPEG
  • 大小: 每张不超过2MB

2. 宣传图片制作

工具:

  • Canva (在线,模板丰富)
  • Figma (专业设计工具)
  • Photoshop (专业)

内容建议:

  • 突出核心功能
  • 使用小红书配色
  • 添加简短slogan

尺寸:

  • 小宣传图: 440x280
  • 大宣传图(可选): 920x680
  • marquee: 1400x560

🔐 安全与隐私

隐私政策模板

如果需要发布到应用商店,建议创建一个简单的隐私政策页面:

# 隐私政策

## 数据收集
本插件不收集、存储或传输任何用户数据。

## 数据使用
- 所有抓取的数据仅保存在用户本地
- 不会上传到任何服务器
- 不会分享给第三方

## 权限说明
- storage: 用于保存用户设置
- downloads: 用于导出CSV文件
- host_permissions: 仅在小红书网站工作

## 联系方式
如有疑问,请联系: your.email@example.com

最后更新: 2024-03-XX

托管方式:

  • GitHub Pages(免费)
  • 自己的网站
  • Google Sites(免费)

📊 应用商店统计

发布后可以查看:

  • 安装量: 总安装次数
  • 用户评分: 平均星级
  • 用户评价: 用户反馈
  • 周活跃用户: 活跃用户数
  • 卸载率: 用户留存情况

定期检查统计数据,根据反馈改进插件!


⚠️ 注意事项

审核可能被拒的原因

  1. 功能问题

    • 插件功能与描述不符
    • 存在明显bug
    • 侵犯用户隐私
  2. 素材问题

    • 截图模糊或误导
    • 图标侵权
    • 描述夸大其词
  3. 政策违规

    • 违反Chrome网上应用店政策
    • 包含恶意代码
    • 滥用API权限

如何应对审核拒绝

  1. 仔细阅读拒绝原因
  2. 修改代码或素材
  3. 在"审核信息"中说明修改
  4. 重新提交审核

🎉 发布成功后

推广渠道

  • GitHub README添加安装链接
  • 小红书官方论坛
  • 技术博客/知乎文章
  • 朋友圈/微信群分享

用户支持

  • 及时回复用户评论
  • 收集反馈意见
  • 定期发布更新

持续改进

  • 根据用户需求添加功能
  • 修复已知bug
  • 优化性能和体验

🔗 相关链接


祝你发布顺利! 🚀