1.11.7 (Nov 24, 2024)

1.11.7 (Nov 24, 2024)

【免费下载链接】viewerjsJavaScript image viewer.项目地址: https://gitcode.com/gh_mirrors/vi/viewerjs

• Use SVG icons for better visual effects (#637).

1.11.6 (Sep 17, 2023)

• Fix an issue where some CSS styles were incompatible with old browsers (#611).

每个版本都包含清晰的日期和相关的issue链接，让用户能够追溯每个变更的背景和原因。 💡 **提示**: 在变更日志中引用issue编号（如#637）不仅提供了上下文，还鼓励用户参与讨论和反馈。 ### 第四步：集成构建和测试流程 ViewerJS的发布脚本不仅仅是更新版本号，还集成了完整的构建和测试流程： ```json { "scripts": { "release": "npm run clean && npm run lint && npm run build && npm run compress && npm run copy && npm test" } }

这个脚本确保每个版本都经过：

1. 清理旧构建文件
2. 代码规范检查
3. 构建生产版本
4. 代码压缩优化
5. 文件复制到文档目录
6. 运行测试套件

⚠️注意: 确保所有测试都通过后再发布版本。ViewerJS使用Karma进行跨浏览器测试，这在前端项目中尤为重要。

第五步：配置持续集成/持续部署

虽然ViewerJS的配置中没有显式的CI/CD配置，但我们可以从package.json中的脚本推断出最佳实践：

1. 自动化测试: 在每次提交时运行测试
2. 代码质量检查: 使用ESLint和Stylelint确保代码质量
3. 构建验证: 确保构建过程在不同环境中都能正常工作
4. 发布自动化: 配置GitHub Actions或GitLab CI自动发布到npm

ViewerJS版本管理实战案例分析

案例一：从1.11.6到1.11.7的平滑升级

让我们分析ViewerJS从1.11.6到1.11.7的升级过程：

## 1.11.7 (Nov 24, 2024) - Use SVG icons for better visual effects (#637).

这个变更属于向后兼容的修订版本更新，因为它：

1. 修复了视觉问题: 使用SVG图标提升视觉效果
2. 保持API兼容: 没有破坏现有功能
3. 有明确的问题追踪: 引用#637 issue

案例二：1.11.0的重大功能更新

## 1.11.0 (Oct 16, 2022) - Add a new option: `initialCoverage` (#314, #526). - Don't load images in the list when hide the navbar (#451). - Support for providing pivot pointer coordinates to `zoom` and `zoomTo` methods (#202).

这是次版本号更新，包含了：

1. 新功能: 新增initialCoverage选项
2. 性能优化: 隐藏导航栏时不加载图片列表
3. API增强: 为缩放方法提供枢轴指针坐标支持

工具链对比与选择建议

主流版本管理工具对比

工具	优点	缺点	适用场景
standard-version	简单易用，与commitlint集成好	功能相对基础	中小型项目
semantic-release	完全自动化，功能强大	配置复杂	大型企业项目
lerna	支持monorepo，版本管理强大	学习曲线陡峭	多包项目
手动管理	完全控制，灵活	容易出错，效率低	不推荐

ViewerJS为什么选择standard-version？

1. 简单性: 配置简单，上手快
2. 社区支持: 有活跃的社区和维护者
3. 与现有工具集成: 完美支持commitlint、husky等工具
4. 灵活性: 可以通过命令行参数定制行为

进阶技巧：处理复杂版本场景

场景一：预发布版本管理

当需要发布测试版本时，可以使用预发布标签：

# 创建alpha版本 npm run release -- --prerelease alpha # 创建beta版本 npm run release -- --prerelease beta # 创建rc版本 npm run release -- --prerelease rc

场景二：跳过版本号

有时需要跳过某些版本号，比如从1.11.7直接跳到2.0.0：

# 手动指定版本号 npm run release -- --release-as 2.0.0

场景三：回退到旧版本

如果新版本有问题，需要回退：

# 撤销版本提交 git reset --hard HEAD~1 git tag -d v1.11.7 # 创建修复版本 git commit -m "fix: revert problematic change" npm run release -- --release-as 1.11.8

常见陷阱与避坑指南

陷阱一：忽略提交信息规范

问题: 团队成员使用随意的提交信息，导致变更日志难以生成。

解决方案: 配置husky钩子，在提交前强制执行commitlint检查：

{ "husky": { "hooks": { "commit-msg": "commitlint -E HUSKY_GIT_PARAMS" } } }

陷阱二：手动修改package.json版本号

问题: 手动修改版本号容易忘记更新CHANGELOG.md和创建Git标签。

解决方案: 始终使用自动化工具更新版本号：

# 错误做法：手动修改package.json # 正确做法：使用standard-version npm run release

陷阱三：忽略测试的重要性

问题: 发布未经测试的版本可能导致生产环境问题。

解决方案: 在发布脚本中集成测试：

{ "scripts": { "release": "npm test && standard-version && git push --follow-tags" } }

【免费下载链接】viewerjsJavaScript image viewer.项目地址: https://gitcode.com/gh_mirrors/vi/viewerjs