Android React-Native Reanimated を作成する際の CMake のパス長の問題を修正する

React Native での CMake ビルド中の一般的なパス長エラー

Windows 上で React Native を使用する開発者は、Android プロジェクトを構築するときにパスの長さの制限に遭遇することがよくあります。繰り返し発生する問題の 1 つは、 反応ネイティブ蘇生 パッケージとその CMake 構成により、ビルドの失敗につながる可能性があります。

このエラーは通常、次のようなメッセージによって示されます。 「mkdir: そのようなファイルまたはディレクトリはありません」これは、Windows オペレーティング システムで許容されるパスの長さを超える特定のディレクトリが作成されることを示唆しています。これは、開発者が次を使用してアプリを構築しようとする場合に特にイライラする可能性があります。 CMake そして 忍者 システムを構築します。

プロジェクトをドライブのルート近くに再配置したり、ビルド構成を変更したりしても、これらのパス長の問題は解決しない場合があります。このような対策は場合によっては役立つかもしれませんが、常に恒久的な修正を提供するとは限りません。

作業中にこの問題が発生した場合は、 反応ネイティブ蘇生、原因を理解し、別の解決策を検討することが重要です。問題、考えられる解決策、将来的にこの複雑さを回避する方法について詳しく見ていきましょう。

ソリューション戦略の詳細な説明

に対処する際に、 パスの長さの問題 構築中 反応ネイティブ蘇生 CMake を使用して Android 上にライブラリを作成し、複数のスクリプトベースのソリューションを実装しました。最初のアプローチでは、プロジェクト ファイルをルート ディレクトリの近くに再配置します。次のような特定のコマンドを含むシェル スクリプトを使用することにより、 cp -r すべてのプロジェクト ファイルをコピーし、 mkdir ターゲット ディレクトリが存在しない場合にそれを作成するため、長いパスに関連するエラーを軽減することを目的としました。これにより、入れ子になった React Native プロジェクトで一般的な、Windows のデフォルトの最大パス長である 260 文字に達するリスクを軽減できます。

もう 1 つの重要な解決策は、CMakeLists ファイルを変更して利用することでした。 相対パス 絶対的なものではなく。この方法は、CMake ビルド プロセス中に長いネストされたディレクトリ パスの生成を防止することで、パスの長さの制限に効果的に対処します。 CMake を使用して相対パスを定義する セット コマンドと次のようなコマンドを使用します 追加ライブラリ そして target_include_directoriesを使用すると、ビルド システムはより短い相対ファイル パスを使用するように指示されるため、「そのようなファイルまたはディレクトリはありません」エラーが発生する可能性が低くなります。

さらに、Windows でロング パスのサポートを有効にすることが、この問題を解決するための重要なステップであることが判明しました。 PowerShell スクリプトは、次を使用して Windows レジストリ キーを変更するように設計されています。 Set-ItemProperty。このコマンドを使用すると、「LongPathsEnabled」オプションを有効にすることで、Windows でデフォルトのパスの長さ制限である 260 文字を回避できます。スクリプトはレジストリ キーが適切に設定されていることを確認し、 Get-ItemProperty コマンドを実行して、変更が成功したことを確認します。この解決策は、他のパス削減方法ではディレクトリ作成エラーを回避するのに不十分な場合に不可欠です。

最後に、PowerShell スクリプトは 開始プロセス を使用したコマンド -動詞 runAs 管理者権限でスクリプトを実行するためのフラグ。レジストリ設定の変更には昇格されたアクセス許可が必要なため、これが必要です。プロジェクト ファイルの移動、CMake 構成の変更、長いパスのサポートの有効化といったこれらの手法を組み合わせることにより、パスの長さに関連する CMake ビルド エラーを解決するための包括的な戦略を作成しました。これらのソリューションは、現在のエラーを軽減するだけでなく、将来のプロジェクトで同様の問題に取り組むための再利用可能なフレームワークも提供します。

# Step 1: Define source and target directories
source_dir="C:/Users/ricar/Documents/Github/StockItUp"
target_dir="C:/StockItUp"

# Step 2: Create target directory if it doesn't exist
if [ ! -d "$target_dir" ]; then
  mkdir "$target_dir"
fi

# Step 3: Copy project files to the target directory
cp -r "$source_dir/"* "$target_dir/"

# Step 4: Confirm completion
echo "Project files moved to $target_dir"

# Set relative paths to reduce absolute path length issues
cmake_minimum_required(VERSION 3.10)

project(reanimated_project)

# Define relative path for source files
set(SOURCE_DIR "src/main/cpp/reanimated")

# Add source files using the relative path
add_library(reanimated STATIC ${SOURCE_DIR}/Common.cpp)

# Specify target properties
target_include_directories(reanimated PRIVATE ${SOURCE_DIR})

# Step 1: Open PowerShell as Administrator
Start-Process powershell -Verb runAs

# Step 2: Set the registry key for long paths
Set-ItemProperty -Path "HKLM:\SYSTEM\CurrentControlSet\Control\FileSystem" -Name "LongPathsEnabled" -Value 1

# Step 3: Confirm the setting
Get-ItemProperty -Path "HKLM:\SYSTEM\CurrentControlSet\Control\FileSystem" -Name "LongPathsEnabled"

パスの長さの制限とビルド戦略への対処

「mkdir: No such file or directory」エラーを解決する際に考慮すべきもう 1 つの重要な側面は、CMake がどのようにファイルまたはディレクトリと対話するかを理解することです。 忍者ビルドシステム。 Ninja は、コードのコンパイル速度と効率の点でよく選ばれますが、Windows のパス長制限との互換性が難しい場合があります。これを回避するには、開発者は過度のパス長を回避する方法で CMake と Ninja を慎重に構成する必要があります。これには、相対パスを使用するようにビルド プロセスをカスタマイズし、ディレクトリ構造を可能な限り単純に保つことが含まれます。

見落とされがちな解決策は、CMake または Ninja が使用するデフォルトのビルド構成を調整して、Windows のファイル システムの制約に適合させることです。たとえば、特定のを追加できます フラグ または、最大パス長を超えない代替ビルド ディレクトリを定義します。さらに、開発者はプロジェクトの依存関係構造を確認して、不必要に深いパスや複雑なパスを特定して短縮することができます。このアプローチにより、コンパイル中のパス関連エラーのリスクを軽減しながら、よりスムーズなビルド エクスペリエンスが保証されます。

次のようなサードパーティ ライブラリの統合を評価することも重要です。 反応ネイティブ蘇生。これらのライブラリには独自の内部ディレクトリ構造があるため、Windows のパス長制限との互換性を確保するには、カスタム調整が必要になる場合があります。ライブラリ固有の CMake 構成を変更するか、ノード モジュールをより短いパスに再配置することで、開発者は重大なパス長の問題が発生しない機能的なビルド環境を維持できます。