このページでは、Windows 互換ルールの作成、VM の一般的な問題、 ポータブルなルールの作成、ソリューションなどです。
パス
問題:
長さの上限: パスの最大長は 259 文字です。
Windows は長いパス（最大 32,767 文字）もサポートしていますが、多くのプログラムは 選択します。
アクションで実行するプログラムについては、注意が必要です。
作業ディレクトリ: 259 文字までに制限されます。
プロセスは、259 文字を超えるディレクトリに
cdすることはできません。大文字と小文字の区別: Windows のパスでは大文字と小文字が区別されません。Unix のパスでは大文字と小文字が区別されます。
アクションのコマンドラインを作成する場合は、この点に注意してください。
パス区切り文字: バックスラッシュ（
\`), not forward slash (/）です。Bazel は、
/セパレータを使用して Unix スタイルのパスを保存します。一部の Windows プログラムは Unix スタイルのパスと、そうでないパスを指定できます。cmd.exe の組み込みコマンドにはこれらをサポートしているものと、サポートしていないものがあります。コマンドを作成する際は、常に
\` separators on Windows: replace/withを使用することをおすすめします。 アクションの行と環境変数を使用します。絶対パス: 先頭をスラッシュ（
/）にしないでください。Windows の絶対パスはドライブ文字で始まります（例:
C:\foo\bar.txt）。単一の ID は ファイルシステムのルートです。ルールでパスが絶対パスかどうかを確認する場合は、この点に注意してください。絶対パス これらは多くの場合ポータブルではないため、避けてください。
ソリューション:
パスを短くします。
長いディレクトリ名、深くネストされたディレクトリ構造、長いファイル名、長いワークスペースは避ける 長いターゲット名などです。
これらはすべて、アクションのパス コンポーネントになり得ます。そのパスの長さが上限に達する可能性があります。 できます。
短い出力ルートを使用します。
--output_user_root=<path>フラグを使用して、Bazel 出力の短いパスを指定します。良いアイデア Bazel 出力（D:\`), and adding this line to your.bazelrc ファイルなど）専用のドライブ（または仮想ドライブ）を用意することです。build --output_user_root=D:/または
build --output_user_root=C:/_bzlジャンクションを使用する。
ジャンクションとは、大まかに言うと[1]ディレクトリのシンボリック リンクです。ジャンクションを簡単に作成できる 長いパスを持つ（同じコンピュータ上の）ディレクトリを指すことができます。ビルド アクションで パスが短くターゲットが長いジャンクションの場合、パス制限が短いツールがアクセスできます。 削除することもできます。
.batファイルまたは cmd.exe で、次のようにジャンクションを作成できます。mklink /J c:\path\to\junction c:\path\to\very\long\target\path[1]: 厳密に言えば、 ジャンクションはシンボリック リンクではありませんが、 ビルド アクションのために、ジャンクションをディレクトリ シンボリック リンクとみなすことができます。
アクション / envvars のパスで
/を `` に置き換える。アクションのコマンドラインまたは環境変数を作成するときは、パスを Windows スタイル。例:
def as_path(p, is_windows): if is_windows: return p.replace("/", "\\") else: return p
環境変数
問題:
大文字と小文字の区別: Windows 環境変数の名前では大文字と小文字が区別されません。
たとえば Java では、
System.getenv("SystemRoot")とSystem.getenv("SYSTEMROOT")は次のようになります。 同じ結果になります（これは他の言語にも当てはまります）。Hermeticity: アクションで使用するカスタム環境変数はできるだけ少なくする必要があります。
環境変数は、アクションのキャッシュキーの一部です。アクションで環境変数を使用する場合 ルールがキャッシュされにくくなります。
ソリューション:
大文字の環境変数名のみを使用します。
これは Windows、macOS、Linux で動作します。
アクション環境を最小限に抑える。
ctx.actions.runを使用する場合は、環境をctx.configuration.default_shell_envに設定します。もし すべての環境変数を辞書に入れて、アクションに渡します。 例:load("@bazel_skylib//lib:dicts.bzl", "dicts") def _make_env(ctx, output_file, is_windows): out_path = output_file.path if is_windows: out_path = out_path.replace("/", "\\") return dicts.add(ctx.configuration.default_shell_env, {"MY_OUTPUT": out_path})
操作
問題:
実行可能な出力: すべての実行ファイルには、実行可能な拡張子が必要です。
最も一般的な拡張子は、
.exe（バイナリ ファイル）と.bat（バッチ スクリプト）です。シェル スクリプト（
.sh）は Windows では実行できないことに注意してください。「新規顧客の獲得」目標をctx.actions.runさんのexecutable。また、ファイルには+x権限がないため、 Linux のように任意のファイルを実行できません。Bash コマンド: 移植性を高めるため、アクション内で Bash コマンドを直接実行しないでください。
Bash は Unix 系のシステムに広く使用されていますが、Windows では使用できないことがよくあります。Bazel 自体は、 Bash（MSYS2）への依存度が下がっているため、将来的にはユーザーが MSYS2 を使用する可能性が低くなる Bazel と一緒にインストールされます。Windows でルールを使いやすくするには、 できます。
改行: Windows では CRLF（
\r\n）、Unix 系システムでは LF（\n）を使用します。テキスト ファイルを比較するときは、この点に注意してください。特に行については、Git の設定に注意してください。 終了することもできます（Git の
core.autocrlf設定をご覧ください）。
ソリューション:
Bash レスの専用ルールを使用する。
native.genrule()は Bash コマンドのラッパーで、単純な問題を解決するためによく使用されます。 ファイルのコピーやテキスト ファイルの書き込みなどを行います。Bash への依存（および wheel）: bazel-skylib に、ニーズに合った専用のルールがあるかどうかを確認します。いずれも Bash に依存しない Windows でビルド/テストした場合。ビルドルールの例:
copy_file()（出典、 こちらのドキュメントをご覧ください）。 ファイルを別の場所にコピーし、必要に応じて実行可能にするwrite_file()（出典、 こちらのドキュメントをご覧ください）。 任意の行末（auto、unix、windows）を付けたテキスト ファイルを書き込みます。 実行可能にする（スクリプトの場合）run_binary()（出典、 こちらのドキュメントをご覧ください）。 指定された入力と想定される出力でバイナリ（または*_binaryルール）をビルド アクションとして実行する （これはctx.actions.runのビルドルール ラッパーです）native_binary()（出典、 こちらのドキュメントをご覧ください）。 ネイティブ バイナリを*_binaryルールでラップします。このルールはbazel runを使用するか、run_binary()のtool属性またはnative.genrule()のtools属性
テストルールの例:
diff_test()（出典、 こちらのドキュメントをご覧ください）。 2 つのファイルの内容を比較するテストnative_test()（出典、 こちらのドキュメントをご覧ください）。*_testルールでネイティブ バイナリをラップします。このルールでは、bazel test
Windows では、些細なことのために
.batスクリプトを使用することを検討してください。.shスクリプトの代わりに、.batスクリプトを使用して簡単なタスクを解決できます。たとえば、何もしないスクリプト、メッセージを出力するスクリプト、または固定メッセージで終了するスクリプトが必要な場合です。 単純な
.batファイルで十分です。ルールによってDefaultInfo()が返された場合 場合、executableフィールドは Windows 上の.batファイルを参照できます。また、macOS と Linux ではファイル拡張子は重要ではないため、いつでも
.batを シェル スクリプトに対しても、この拡張機能を使用できます。空の
.batファイルは実行できません。空のスクリプトが必要な場合は、スペースを 1 つ記述してください。 含まれています。原則に基づいて Bash を使用する。
Starlark のビルドルールとテストルールで、
ctx.actions.run_shellを使用して Bash スクリプトと Bash を実行する 使用できます。Starlark マクロで、Bash スクリプトとコマンドを
native.sh_binary()でラップするか、native.genrule()。Bazel は、Bash が使用可能かどうかを確認し、スクリプトまたはコマンドを 。Starlark リポジトリ ルールでは、Bash を完全に避けるようにしてください。Bazel では現在、実行する方法がない リポジトリ ルールの原則に沿った Bash コマンド。
ファイルの削除
問題:
開いている間はファイルを削除できません。
開いているファイルは（デフォルトでは）削除できず、試行すると「アクセスが拒否されました」と表示されます。 表示されます。ファイルを削除できない場合、実行中のプロセスがまだそのファイルを保持している可能性があります 表示されます。
実行中のプロセスの作業ディレクトリは削除できません。
プロセスには作業ディレクトリへのハンドルが開いているため、ディレクトリを削除できません 待機状態を維持します。
ソリューション:
コードでは、ファイルを積極的に閉じてみます。
Java では、
try-with-resourcesを使用します。Python では、with open(...) as f:を使用します。原則として、 なるべく早くハンドルを閉じましょう。