モノレポに関する問題と解決策

このページでは、Vega Studioでモノレポを使用するときによくある問題と解決策について説明します。ここで特定の問題の解決策が見つからない場合は、開発者フォーラムに問題を投稿して追加のサポートを受けてください。

パッケージマネージャーがサポートされていない

原因： Vega StudioでnpmまたはYarn v2以外のパッケージマネージャーを使用すると、エラーが表示されるか、ビルドに失敗します。Vega Studioでは、npmとyarn v2 CLIのみがサポートされています。他のパッケージマネージャーはビルドシステムでは正しく動作しません。

解決策： サポートされているパッケージマネージャーを使用します。

• 標準的なパッケージ管理：npm
• 高度なワークスペース機能：Yarn v2以降

パッケージマネージャーが検出されない

原因： Vega Studioがモノレポ内のパッケージマネージャーを検出できず、デフォルトのnpmに設定されます。空のモノレポやクリーンなモノレポでは、検出が難しい場合があります。Vega Studioのデフォルトはnpmですが、お使いの設定には該当しない場合があります。

解決策： 次の手順で、Vega Studioがパッケージマネージャーを識別できるようにします。

1. 依存関係を手動でインストールします（npmの場合はnpm install、Yarnの場合はyarn install）。
2. モノレポのルートディレクトリに、適切なロックファイル（package-lock.jsonまたはyarn.lock）を配置します（空のファイルでも構いません）。

「ターボモジュールのtgzへの依存関係が見つからない、または形式が正しくない」というエラーでビルドに失敗する

原因： ビルドシステムが、package.json依存関係で参照されている.tgzファイルを見つけるまたは処理することができません。

解決策： tgzへのファイル参照を最新のパッケージバージョンに置き換えます。

コードをコピー クリップボードにコピーしました。

// 次の行を
"@prefix/module-name": "file:...../prefix-module-name-0.0.1.tgz"
// 次のように置き換えます。
"@prefix/module-name": "*"

モノレポの設定中にnpmのインストールが失敗する

原因： npmがインストールされていないか、.npmrc設定が正しくないか、または親ディレクトリに競合するファイルがあります。

解決策：

1. npmがインストールされていることを確認します。

   コードをコピー クリップボードにコピーしました。

   npm -v
   

2. .npmrcが存在し、正しいことを確認します。

3. 親フォルダまたはホームフォルダで、競合するファイルやディレクトリを削除します。

• package.jsonファイル
• node_modulesディレクトリ
• npmアーティファクト

モノレポの設定中にYarnのインストールが失敗する

原因： Yarnのバージョンが正しくないか、Yarnがインストールされていないか、または競合する設定ファイルがあります。

解決策：

1. Yarn v2以降を使用していることを確認します。

   コードをコピー クリップボードにコピーしました。

   yarn --version
   

2. Yarn 1が存在する場合はアンインストールします。

3. corepack（nodeバージョン14以降）を使用してYarnをインストールします。

   コードをコピー クリップボードにコピーしました。

   corepack enable
   

4. package.jsonで、適切なパッケージマネージャーを指定します。

   コードをコピー クリップボードにコピーしました。

   "packageManager": "yarn@x.y.z"
   

5. Yarnを準備します。

   コードをコピー クリップボードにコピーしました。

   corepack prepare yarn@x.y.z --activate
   

6. モノレポのルートに、空のyarn.lockファイルを作成します。
7. 親フォルダまたはホームフォルダで、競合するファイルやディレクトリを削除します。

• package.json、package-lock.json、yarn.lock
• node_modulesディレクトリ
• npmアーティファクト

Yarnの依存関係のインストール時にビルドが失敗します。

原因： Yarnリポジトリの構成が正しくないか、.yarnrc.ymlファイルに認証トークンがありません。

解決策：

1. Yarnリポジトリ（.yarnrc.ymlファイル）を正しく構成します。

   手順については、Yarnワークスペースの構成を参照してください。

2. 必要に応じて、以下の構成を.yarnrc.ymlに追加します。

   コードをコピー クリップボードにコピーしました。

   npmRegistries:
   "https://k-artifactory-external.labcollab.net/artifactory/api/npm/kepler-npm-prod-local/":
   npmAuthToken: "<Keplerトークン>"
   

Metroパッケージャーの使用時に、パッケージングのステップでビルドが失敗します。

原因： パス構成が正しくないため、Metroパッケージャーがモノレポ構造の依存関係を解決できません。

解決策： metro.config.jsで依存関係を構成します。

コードをコピー クリップボードにコピーしました。

const path = require('path');

const config = {
    projectRoot: __dirname,
  watchFolders: [
    path.resolve(__dirname, '../../packages'),
    path.resolve(__dirname, '../../node_modules')
  ],
  resolver: {
    disableHierarchicalLookup: true,
    nodeModulesPaths: [
      path.resolve(__dirname, 'node_modules'),
      path.resolve(__dirname, '../../node_modules')
    ]
  }
};

関連トピック

• Vega Studioの使用方法
• Yarnワークスペースのセットアップ

Last updated: 2025年9月30日