Version Tagging in Capacitor Apps

版本标签对于管理 Capacitor 在 Capgo 中，应用程序的版本标记确保了平滑的更新、跟踪变更以及在 iOS、Android 和 web 平台上的应用程序可靠性。以下是一些快速概述:

• 为什么它很重要: 跟踪更新、启用回滚以及确保稳定的部署。
• 语义版本: 使用 MAJOR.MINOR.PATCH 来表示破坏性更改、新增功能或 bug 修复。
• 跨平台同步: 在 package.jsoniOS Info.plist、 build.gradle.
• Android: 自动化更新 与 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 管理

版本标记简化 app updates让用户感到满意，确保开发者能够有效地管理发布。

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

在 Capacitor 中设置版本

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

在 package.json

文件是您的应用程序版本详细信息的主要来源。以下是如何设置它的示例： package.json 文件

{
  "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"
  }
}

当更新版本号时，请遵循语义版本 (SemVer) 规则：

• 主版本 (1.x.x): 引入破坏性更改。
• 次版本 (x.2.x): 添加后向兼容的新功能。
• 修订版本 (x.x.3): 修复 bug 或进行小幅改进。

保持平台版本的一致性

保持所有平台版本号的一致性对于顺利部署应用程序非常重要。每个平台都有自己的配置文件来管理版本号：

在更新版本号后，使用以下命令同步更新至原生平台配置： package.json使用__CAPGO_KEEP_0__ __CAPGO_KEEP_1__进行版本管理

npx cap sync

Using Capacitor CLI for __CAPGO_KEEP_2__ Management

The Capacitor CLI offers helpful commands to manage versions:

# 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

Keeping your Capacitor CLI updated ensures compatibility with version-specific features and reduces potential mismatches. Following these steps will help you maintain proper versioning in your app.

语义版本设置

语义版本基础

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

这个系统确保开发者可以清晰地传达更新信息，同时在应用程序版本之间保持兼容性。例如，从 1.2.3 __CAPGO_KEEP_0__ 2.0.0 到

指示需要谨慎规划的重大、破坏性更新。

何时更新版本号

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

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

版本更新自动化

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

1. NPM版本脚本

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

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

2. CI/CD 集成
   在CI/CD管道中包含版本更新。Capgo支持工具，如 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. 版本进展

使用清晰的版本进展系统来跟踪开发阶段:

这种方法确保了充分的测试和开发阶段之间的smooth过渡，保持版本跟踪的组织和透明。

应用程序版本显示

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

获取版本号：Capacitor

您可以使用Capacitor获取版本号信息：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()"
    />
  `
})

对于企业应用，Capgo的通道系统允许您控制更新分发:

本方法确保应用程序可靠性，同时通过Capgo的分析仪表板跟踪更新性能。

版本管理解决方案

让我们深入了解高级版本管理解决方案。

版本工具选项

When selecting version control tools, it’s important to focus on those that simplify updates, secure your code, and support both app store releases and live updates.

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

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

Capgo Capgo 提交 PR

Capgo 实时更新控制台界面

• __CAPGO_KEEP_0__ 提供强大的版本管理功能，包括：
• 2.35亿次成功更新
• 95% 的用户在 24 小时内更新
• 434ms average API response time worldwide

434ms 的平均 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 进行版本控制的示例： [1]

“我们正在尝试使用 @__CAPGO_KEEP_0__，因为 Appcenter 停止对混合应用的实时更新支持，而 @AppFlow 的费用太高了。” - Simon Flack”

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

For larger teams, Capgo’s channel system enables precise control over version deployment:

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

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

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

Capgo also includes an analytics dashboard to monitor version adoption rates and detect potential issues early. With built-in encryption and customizable hosting options, teams can maintain security while scaling their deployment workflows.

企业

企业

企业

企业

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

开始

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

• 设置版本跟踪: 在文件中使用语义版本控制，并集成必要的插件。 package.json 添加更新检查
• : 实现系统来验证和跟踪版本更新。配置分发渠道
• : 为生产、beta 和开发环境创建单独的环境。__CAPGO_KEEP_0__

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

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

如果您正在使用 版本标签在Capacitor应用中 如果您正在使用 版本标签在__CAPGO_KEEP_0__应用中 来规划回滚和版本控制，连接它与 回滚 回滚的实施细节在 版本目标 上下文:Capgo解决方案营销页面。角色:部分或页面标题。见于：页面解决方案/版本目标.astro。消息键`solutions_version_targeting_title`（解决方案版本目标标题）。|上下文:Capgo解决方案营销页面。角色:短UI标签或导航项。见于：页面解决方案/版本目标.astro。消息键`solutions_version_targeting`（解决方案版本目标）。 回滚的实施细节在版本目标中， 为捆绑包的实现细节 Capgo 实时更新 为 Capgo 实时更新中的产品工作流