Version Tagging in Capacitor Apps

版本标记对于管理应用程序至关重要 Capacitor 在Capacitor应用程序中使用版本标记

• 版本标记对于应用程序管理至关重要。它确保更新顺畅、跟踪更改并在iOS、Android和Web平台上提高应用程序可靠性。以下是快速概述:为什么它很重要
• :跟踪更新、启用回滚并确保稳定的部署语义版本 :使用 MAJOR.MINOR.PATCH
• 来表示重大更改、新增功能或bug修复跨平台同步 package.json:在iOS、Android和Web上同步版本号 Info.plist，和Android build.gradle.
• 自动化: 自动更新 使用npm脚本和CI/CD工具。
• 实时更新区域: 首页问题/解决方案部分。角色: 部分或页面标题。见于: 页面premium-support.astro。消息键`ps_help_updates_title` (Ps Help Updates Title)。 Capgo __CAPGO_KEEP_0__
• 区域: Capgo营销网站。角色: 网站副本句子。见于: 页面contributing.astro。保留Capgo产品/品牌和开发者术语的原始形式。消息键`submitting_a_pr_to_capgo` (Submitting A Pr To Capgo)。在24小时内将更新推送给95%的用户。

Beta管理

版本标签简化 应用更新使用户满意，确保开发者可以有效地管理发布。

如何自动配置您的 Capacitor 项目 ⚡️

版本设置在 Capacitor

按照以下步骤确保您的 Capacitor 应用在所有平台上都有统一的版本管理。

设置版本 package.json

The package.json file serves as the main source for your app’s version details. Here’s an example of how to set it up:

{
  "name": "your-app-name",
  "version": "1.2.3",
  "private": true,
  "dependencies": {
    "@capacitor/core": "5.5.0",
    "@capacitor/ios": "5.5.0",
    "@capacitor/android": "5.5.0"
  }
}

When updating the version number, use semantic versioning (SemVer) rules:

• Major version (1.x.x): Introduces breaking changes.
• Minor version (x.2.x): Adds new features that are backward-compatible.
• Patch version (x.x.3): Fixes bugs or makes small improvements.

Keeping Platform Versions in Sync

It’s important to align version numbers across all platforms for smooth app deployment. Each platform has its own configuration file for versioning:

更新版本后 package.json，使用此命令同步更改与本机平台配置:

npx cap sync

使用 Capacitor CLI 进行版本管理

Capacitor CLI 提供有用的命令来管理版本:

# Check the current version of Capacitor
npx cap --version

# Update Capacitor core and platform dependencies
npm install @capacitor/core@latest
npm install @capacitor/ios@latest
npm install @capacitor/android@latest

# Sync version changes to native platforms
npx cap sync

保持您的 Capacitor CLI 更新以确保与特定版本的功能兼容性，并减少潜在的不匹配。按照这些步骤可以帮助您维护应用程序的正确版本。

语义版本设置

语义版本基础

语义版本（SemVer） 使用以下格式 主版本.修订版本.修订版本，其中每个部分表示特定类型的更改:

这个系统确保开发者可以清晰地传达更新信息，同时在应用程序版本之间保留兼容性。例如，从 1.2.3 到 2.0.0 表示需要小心规划的重大、破坏性更新。

何时更新版本号

以下是如何决定更新哪个版本号的步骤:

“We practice agile development and @Capgo is mission-critical in delivering continuously to our users!” - Rodrigo Mantica [1]

我们实践敏捷开发，@__CAPGO_KEEP_0__在持续交付给用户方面是 mission-critical！

现在让我们来看看如何自动化这些更新以简化发布管理。

版本更新自动化 可以节省时间并减少错误在您的Capacitor项目中。以下是如何设置它的步骤：

1. NPM版本脚本

将这些脚本添加到您的 package.json 文件中，以便轻松管理版本更新:

{
  "scripts": {
    "version:patch": "npm version patch",
    "version:minor": "npm version minor",
    "version:major": "npm version major"
  }
}

2. CI/CD集成
   Incorporate version updates into your CI/CD pipeline. Capgo supports tools like GitHub Actions, GitLab CI,和 Jenkins,使其简单地自动化流程。

“@Capgo是开发人员寻求提高生产力并绕过繁琐的bug修复审查的必备工具。” - Bessie Cooper [1]

版本标签方法

Git版本标签

Git版本标签是可靠的跟踪 Capacitor 应用程序发布。要创建清晰和详细的标签，结合语义版本控制和简要描述:

git tag -a v1.2.3 -m "Release v1.2.3: Added offline mode support"

为了保持团队中的一致性，使用标准化的标签格式:

构建号整合

构建号有助于在每个版本中跟踪单个构建。对于 iOS 和 Android，应在每次提交时将构建号递增:

{
  "ios": {
    "version": "1.2.3",
    "build": "10234"
  },
  "android": {
    "version": "1.2.3",
    "versionCode": "10234"
  }
}

构建号应始终递增，即使版本保持不变。这确保了每个应用商店提交都具有唯一标识，同时保持版本清晰。

Beta 版本管理

管理 Beta 版本需要一个结构化的过程来分发测试构建。Capgo的 渠道系统 简化了以下步骤:

1. 频道设置

为每个测试阶段创建独立的频道:

{
  "beta": {
    "version": "1.3.0-beta.1",
    "users": "beta-testers"
  },
  "production": {
    "version": "1.2.3",
    "users": "all"
  }
}

2. 控制用户访问

设置权限以控制谁可以访问beta版本。这确保了只有经过批准的测试者才能接收beta版本，而生产用户则接收稳定的发布。

3. 版本进展

阶段

通过这种方法可以确保充分的测试和开发阶段的平滑过渡，保持版本跟踪的组织和透明性。

应用程序版本显示

在应用程序中准确显示版本信息对于保持用户知情和有效管理更新至关重要。

Getting Version with Capacitor

You can retrieve version details using Capacitor with this code:

import { App } from '@capacitor/app';

async function getAppInfo() {
  const info = await App.getInfo();
  console.log(`Version: ${info.version}`);
  console.log(`Build: ${info.build}`);
}

为了更简洁的实现，创建一个可重用的函数

export const getVersionString = async () => {
  const info = await App.getInfo();
  return `v${info.version} (${info.build})`;
};

这个函数简化了在应用程序界面中显示版本信息的过程

版本UI实现

以下是如何将版本信息整合到设置组件中的示例

@Component({
  selector: 'app-settings',
  template: `
    <div class="version-info">
      <span>Version: {{ versionString }}</span>
      <span *ngIf="updateAvailable" class="update-badge">
        Update Available
      </span>
    </div>
  `
})

常见的显示版本详细信息的位置包括

除了显示版本信息外，集成更新检查系统还可以提高用户体验。

更新检查系统

更新检查系统确保用户可以访问最新的功能和修复。Capgo提供实时通知和受控更新通道来管理此过程:

import { CapacitorUpdater } from '@capgo/capacitor-updater';

async function checkForUpdates() {
  const current = await CapacitorUpdater.current();
  const latest = await CapacitorUpdater.getLatest();

  if (current.version !== latest.version) {
    await CapacitorUpdater.download({
      version: latest.version
    });
  }
}

“我们实行敏捷开发，@Capgo在持续交付给用户方面是 mission-critical!” - Rodrigo Mantica [1]

您还可以添加一个用户可见的更新通知，如下所示：

@Component({
  template: `
    <update-modal 
      [version]="newVersion"
      [features]="updateFeatures"
      (updateNow)="performUpdate()"
    />
  `
})

For enterprise apps, Capgo的渠道系统允许您控制更新分发:

通过Capgo的分析仪表盘来跟踪更新性能，这种方法确保了应用程序的可靠性

版本管理解决方案

让我们深入了解如何有效地管理应用程序版本

版本工具选项

选择版本控制工具时，应重点关注那些简化更新、保护您的code并支持应用商店发布和实时更新的工具

以下是您需要关注的关键功能

在这个领域的一个突出工具是 Capgo，它提供了专门为 Capacitor 应用.

Capgo 版本控制功能

Capgo 提供了强大的版本管理功能，包括：

• 23.5亿次更新成功交付
• 95% 的用户在 24 小时内完成了更新
• 82% 的全球成功率
• 434毫秒全球平均API响应时间

在Capacitor应用程序中使用Capgo进行版本控制的示例

// Capgo version control example
import { CapacitorUpdater } from '@capgo/capacitor-updater';

const versionControl = {
  async checkVersion() {
    const current = await CapacitorUpdater.current();
    return current.version;
  },

  async deployUpdate(version: string) {
    await CapacitorUpdater.setChannel({
      channel: 'production',
      version: version
    });
  }
};

“我们目前正在尝试@Capgo，因为Appcenter停止了对混合应用程序的实时更新支持，而@AppFlow的费用太高了。” - Simon Flack [1]

团队大小解决方案

Capgo 提供灵活的计划来满足所有大小的团队，实现版本管理的可伸缩性和高效性。

对于更大的团队，Capgo 的频道系统使得版本部署具有精确的控制权：

const enterpriseVersionControl = {
  channels: {
    production: 'stable-releases',
    beta: 'early-access',
    internal: 'development'
  },

  async deployToChannel(channel: string, version: string) {
    await CapacitorUpdater.setChannel({
      channel: channel,
      version: version
    });
  }
};

“我们实行敏捷开发，@Capgo 在交付持续更新给我们的用户方面是 mission-critical！” - Rodrigo Mantica [1]

Capgo 还包括一个分析仪表板，用于监控版本采用率并及早检测潜在问题。通过内置加密和可定制的托管选项，团队可以在扩展部署工作流程的同时保持安全。

结论

理解版本标记是简化开发和部署过程的关键。以下是主要思想和步骤的快速回顾，供您开始时参考。

关键要点

版本标记有助于开发人员维护平滑和可靠的更新。正确的版本控制提供了明显的优势:

这些结果突出了使用有效的版本管理工具的重要性。

开始

为了实现这些好处，请遵循以下步骤：

• 设置版本跟踪: 在文件中使用语义版本控制，并集成必要的插件。 package.json 添加更新检查
• : 实现系统来验证和跟踪版本更新。这些结果突出了使用有效的版本管理工具的重要性。
• 配置发布渠道: 为生产、beta 和开发环境创建单独的环境。

最后，考虑添加一个实时更新系统，以确保部署既快又安全。

继续阅读关于 Capacitor 应用的版本标记

如果您正在使用 版本标记在 Capacitor 应用 来规划回滚和版本控制，连接它与 回滚 回滚的实施细节在回滚中 版本目标 上下文:Capgo解决方案营销页面。角色:节或页面标题。见于:页面解决方案/版本目标.astro。消息键`解决方案_版本目标_标题` (解决方案版本目标标题)。|页面:Capgo解决方案营销页面。角色:短UI标签或导航项。见于:页面解决方案/版本目标.astro。消息键`解决方案_版本目标` (解决方案版本目标)。 回滚的实施细节在版本目标中， 为 __CAPGO_KEEP_0__ Update Behavior 的实现细节 bundle 为 bundle 的实现细节，并且 Capgo Live Updates 为 Capgo Live Updates 的产品工作流。