__CAPGO_KEEP_0__

Version Tagging in Capacitor Apps

Learn the essentials of version tagging in Capacitor apps, including best practices for updates, synchronization, and automation.

Martin Donadieu

Martin Donadieu

Content Marketer

Version Tagging in Capacitor Apps

Version tagging is essential for managing Capacitor apps. It ensures smooth updates, tracks changes, and enhances app reliability across iOS, Android, and web platforms. Here’s a quick overview:

  • Why It Matters: __CAPGO_KEEP_0__を追跡し、ロールバックを有効化し、安定したデプロイメントを保証します。
  • Semantic Versioning: 使用 MAJOR.MINOR.PATCH を使用して、破壊的な変更、新機能、またはバグ修正を示します。
  • Sync Across Platforms: package.json, Info.plist, build.gradle.
  • ,: Automation : npmスクリプトとCI/CDツールを使用して、更新を自動化します。
  • リアルタイム更新ツールとしては Capgo 95%のユーザーに24時間以内に更新を配信します。
  • ベータ管理バージョン管理のための構造化されたチャネルを使用します。

比較

機能目的
シナリオベースのバージョニング変更を明確に追跡します1.2.3 → 2.0.0
バージョン同期プラットフォームを横断するnpx cap sync
自動化バージョン更新を高速化npm version patch
ライブ更新ユーザー採用を速めるCapgoの24時間以内に95%
ベータチャネル制御されたテストフェーズ1.3.0-beta.1

バージョンタグ付けが簡素化 アプリ更新ユーザーを満足させ、開発者がリリースを管理できるようにする

How to __AUTOMATICALLY__ configure your Capacitor project ⚡️

Capacitor

Version Setup in Capacitor

Version Setup in Capacitor

のバージョン管理をすべてのプラットフォームで一貫して行うには、以下の手順に従ってください。 package.json

Setting the Version in 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: (1.x.x): バージョンアップの変更点が含まれます。
  • 小さなバージョン (x.2.x): バックアップ互換性のある新機能を追加します。
  • 修正バージョン (x.x.3): バグの修正や小さな改善を行います。

プラットフォームバージョンの同期

アプリのデプロイがスムーズになるように、すべてのプラットフォームのバージョン番号を同期することが重要です。各プラットフォームには、バージョニングのための独自の設定ファイルがあります:

プラットフォーム設定ファイルバージョンキー
iOSInfo.plistCFBundleShortVersionString
Androidbuild.gradleversionName
Webpackage.jsonversion

バージョンを更新した後、 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

After updating the version in Capacitor CLI, use this command to sync the changes with native platform configurations: __CAPGO_KEEP_2__ __CAPGO_KEEP_3__ __CAPGO_KEEP_4__ __CAPGO_KEEP_5__ __CAPGO_KEEP_6__ __CAPGO_KEEP_7__ __CAPGO_KEEP_8__ __CAPGO_KEEP_9__

セマンティック バージョン設定

セマンティック バージョン基本

セマンティック バージョニング (SemVer) __CAPGO_KEEP_0__で使用される形式 メジャー.マイナー.パッチ, それぞれの部分は特定のタイプの変更を示します:

バージョン コンポーネント目的
メジャーAPIの破壊的な変更を導入します
マイナー前のバージョンと互換性のある新機能を追加します
PATCHバグを修正またはパフォーマンスを向上させることができるが、互換性を維持しながら

このシステムは、開発者が明確に更新を伝えながら、互換性を保ったままアプリのバージョンを跨ぐことができるようにします。例えば、 1.2.3 から 2.0.0

重大な変更や破壊的な更新を伴うため、慎重な計画が必要な

バージョン番号を更新するときはどの時にするか

バージョン番号を更新する方法更新タイプ使用するとき
バージョン番号の変更の例For breaking API changes or major UI redesigns1.2.3 → 2.0.0
Minor Update新機能の導入や機能の廃止をマークする場合1.2.3 → 1.3.0
Patch Updateバグ修正や小さなパフォーマンスのチューニング1.2.3 → 1.2.4

「我々はアジャイル開発を実践し、@Capgoはユーザーに継続的に提供するmission-criticalなものです!」 - Rodrigo Mantica [1]

ここでは、リリース管理を簡素化するために、これらの更新を自動化してみましょう。

バージョン更新の自動化

バージョン更新を自動化することで、__CAPGO_KEEP_0__プロジェクトで時間を節約し、エラーを減らすことができます。ここでは、設定方法を紹介します。 Capacitor バージョン スクリプト

  1. NPMのバージョン更新を簡単に管理するには、これらのスクリプトをファイルに追加してください。

ファイルに追加するスクリプト package.json ファイルに追加するスクリプト

{
  "scripts": {
    "version:patch": "npm version patch",
    "version:minor": "npm version minor",
    "version:major": "npm version major"
  }
}
  1. CI/CD Integration
    Incorporate version updates into your CI/CD pipeline. Capgo supports tools like Incorporate version updates into your CI/CD pipeline. GitHub supports tools like, __CAPGO_KEEP_0__ ActionsGitLab CI 、およびJenkins

“@Capgo is a must-have tool for developers seeking productivity by bypassing lengthy bugfix reviews.” - Bessie Cooper [1]

“@__CAPGO_KEEP_0__ は、開発者が長時間のバグ修正レビューを回避することで生産性を高めることを目指す開発者にとって不可欠なツールです。” - Bessie Cooper

Version Tag Methods

Git Version Tags Git version tagsは、Capacitor アプリのリリースを追跡するのに信頼できる方法です. バージョン情報を明確に表すタグを作成するには、シーケンスバージョンと簡潔な説明を組み合わせてください。

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

チーム全体で一貫性を保つには、標準化されたタグ形式を使用してください。

タグフォーマット
リリースバージョンv[MAJOR].[MINOR].[PATCH]v1.2.3
ベータ版リリースv[VERSION]-beta.[NUMBER]v1.2.3-beta.1
リリース候補v[VERSION]-rc.[NUMBER]v1.2.3-rc.2

ビルド番号統合

ビルド番号は、各バージョン内で個別のビルドを追跡するのに役立ちます。iOSとAndroidの両方で、提出ごとにビルド番号をインクリメントしてください。

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

ビルド番号は常に増加する必要があります。バージョンが同じままでも、各アプリストアの提出を一意に識別し、ユーザーにとってバージョニングを明確に保つことができます。

ベータ版バージョン管理

ベータ版バージョンの管理には、テストビルドを配布するための構造化されたプロセスが必要です。Capgoの チャンネルシステム 以下の手順で簡素化されます。

  1. チャンネル設定

各テストフェーズ用に別々のチャンネルを作成してください。

{
  "beta": {
    "version": "1.3.0-beta.1",
    "users": "beta-testers"
  },
  "production": {
    "version": "1.2.3",
    "users": "all"
  }
}
  1. ユーザーへのアクセス制御

__CAPGO_KEEP_0__を設定して、ベータ版へのアクセスを制御する権限を設定します。

  1. __CAPGO_KEEP_1__

__CAPGO_KEEP_2__を使用して、開発段階を追跡するための明確なバージョン進行システムを設定します。

__CAPGO_KEEP_3____CAPGO_KEEP_4____CAPGO_KEEP_5__
__CAPGO_KEEP_6__1.3.0-alpha.1__CAPGO_KEEP_7__
__CAPGO_KEEP_8____CAPGO_KEEP_9____CAPGO_KEEP_10__
RC (Release Candidate)1.3.0-rc.1リリース前の最終テスト
本番1.3.0公開

このアプローチは、開発段階間のスムーズな移行を保証し、バージョン管理を整理し、透明性を保ちながら、プロセス全体でバージョン追跡を実施します。

アプリバージョン表示

アプリ内で正確なバージョン情報を表示することは、ユーザーを情報提供し、更新を効果的に管理するために不可欠です。

バージョンを取得するには 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>
  `
})

バージョン詳細を表示する一般的な場所は次のとおりです。

場所目的実装
設定画面フルバージョンとビルド詳細なバージョン情報
アバウト ページ基本的なバージョン表示バージョン番号のみ
App Footer最小表示簡略表示文字

バージョン情報を表示するだけでなく、更新チェックシステムを統合することで、ユーザー体験を向上させることができます。

更新チェックシステム

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の分析ダッシュボードを通じてアップデートのパフォーマンスを追跡します。

バージョン管理ソリューション

バージョン管理の高度なソリューションについて詳しく見てみましょう。

バージョン管理ツールの選択肢

バージョン管理ツールを選択する際は、更新を簡素化し、ユーザーの code を保護し、両方のアプリストアのリリースとライブアップデートをサポートするものに焦点を当てることが重要です。

以下の重要な機能を探してみましょう。

機能重要度影響
ライブアップデート重要アプリストアのレビューによる遅延を最小限に抑える
セキュリティ必須ユーザーのデータと code の完整性を保護する
AnalyticsImportantMeasures update success and user adoption
CI/CD IntegrationUsefulStreamlines deployment processes
Cost EfficiencyStrategicInfluences long-term budget planning

One standout tool in this space is Capgo, which offers features specifically designed for Capacitor.

Capgo appsのための機能を提供するCapgo バージョン管理機能

Capgo Live Update ダッシュボード インターフェース

Capgoは、以下のバージョン管理機能を提供しています。

  • 23.5Mの成功更新を実行
  • 24時間以内に95%のユーザーが更新
  • 82%のグローバル成功率
  • 世界中で平均434msのAPI応答時間

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
    });
  }
};

“We are currently giving a try to @Capgo since Appcenter stopped live updates support on hybrid apps and @AppFlow is way too expensive.” - Simon Flack [1]

チームサイズ対応ソリューション

Capgoは、チームのサイズに関係なく、バージョン管理をスケーラブルかつ効率的に行うための柔軟なプランを提供しています。

チームサイズプラン主な機能
1人開発者基本クラウドホスティングライブ更新、1,000 MAU
小規模チーム(2-5)メーカープラン10,000 MAU、500GB バンド幅
中規模チーム(6-20)チームプラン100,000 MAU、権限
エンタープライズカスタムPAYG無制限MAU、専用サポート

より大きなチーム向けには、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には、バージョンの採用率を監視し、潜在的な問題を早期に検出するための分析ダッシュボードも含まれています。組み込みの暗号化とカスタマイズ可能なホスティングオプションを備えているため、チームはセキュリティを維持しながら展開ワークフローを拡大できます。

結論

バージョンタグの理解は、開発と展開プロセスの簡素化に鍵となります。ここでは、主なアイデアとステップを簡単にまとめてみました。

重要なポイント

バージョンタグは、開発者がスムーズで信頼性の高い更新を維持するのに役立ちます。適切なバージョン管理は、以下のような利点を提供します:

利点影響結果
即時更新短いレビューのタイムラインユーザーの迅速な採用 [1]
バージョン管理より良いcode管理高い成功率 [1]
更新の追跡リアルタイムの監視迅速な問題の解決 [1]
配布の制御ターゲットされたロールアウト多プラットフォームのサポート

バージョン管理ツールの効果的な使用の重要性を強調する結果です。

はじめに

これらの利点を実現するには、以下の手順に従ってください。

  • バージョン追跡の設定: __CAPGO_KEEP_0__ アプリのバージョン タギングから続けて、ファイルに意味的なバージョニングを設定し、必要なプラグインを統合する。 package.json 更新チェックの追加
  • : バージョンアップデートの検証と追跡システムを実装する。配布チャンネルの設定
  • : 製品、ベータ、開発用に別々の環境を作成する。最後に、迅速かつ安全なデプロイを保証するために、ライブアップデートシステムを考慮する。

Version Tagging in __CAPGO_KEEP_0__ Apps から続けてください。

Capacitor

あなたが Capacitorアプリケーションで バージョンタグ付けを使用して ロールバックとバージョン管理を計画する場合 __CAPGO_KEEP_0__に接続してください ロールバック ロールバックの実装詳細について バージョン目標 バージョン目標の実装詳細について 更新動作 更新動作の実装詳細について Capgo Live Updates 製品ワークフローにおけるCapgo Live Updatesの機能についてです。

Capacitor アプリのリアルタイム更新

ウェブ層のバグが生じた場合、Capgo を使用して修正を配信するのではなく、数日間待ってアプリストアの承認を待つのではなく、ユーザーはバックグラウンドで更新を受け取り、ネイティブの変更は通常のレビュー経路で残ります。

今すぐ始めましょう

最新のブログ記事

Capgoは、プロフェッショナルなモバイルアプリを作成するために必要な最良の洞察を提供します。