短所 - クラウドでオンライン

プログラム：

NAME

短所 - ソフトウェア構築システム

DESCRIPTION

バージョン 2.2.0 のガイドとリファレンス

Copyright（c）1996-2000 Free Software Foundation、Inc。

このプログラムは自由ソフトウェアです。 あなたはそれを再配布および/またはそれを変更することができます
Free SoftwareFoundationによって発行されたGNUGeneral Public License; また
ライセンスのバージョン2、または（オプションで）それ以降のバージョン。

このプログラムは、役立つことを期待して配布されていますが、いかなる保証もありません。
商品性または特定目的への適合性の黙示の保証もありません。
詳細については、GNU General PublicLicenseを参照してください。

このプログラムと一緒にGNUGeneral PublicLicenseのコピーを受け取っているはずです。
COPYING ファイルを参照してください。 そうでない場合は、Free Software Foundation, Inc., 59 Temple までご連絡ください。
場所 - スイート 330、ボストン、マサチューセッツ州 02111-1307、米国。

概要

デメリット 主にソフトウェアを構築するためのシステムですが、
以前のソフトウェア構築システム。 短所は対処するためにゼロから設計されました
複数のソース ディレクトリにまたがるソフトウェアを簡単に構築できます。 短所
シンプルで理解しやすく、保守しやすいビルド スクリプトを簡単に作成できます。
短所は、複雑なソフトウェアが簡単かつ正確に再現できることを保証します。

Cons は、これらすべてを達成するために多くの手法を使用します。 コンストラクション スクリプトは
Perl スクリプト。理解しやすく、非常に柔軟です。 のグローバル スコーピング
変数間で情報を共有するためのインポート/エクスポート メカニズムに置き換えられます。
これにより、各スクリプトの可読性と保守性が大幅に向上します。
構造 環境 が導入されています: これらは、
ビルド プロセスを制御するために必要な情報。 複数の環境が使用されている
ビルド ツリーで製品を生成するために異なるセマンティクスが必要な場合。 短所
自動依存関係分析を実装し、これを使用して全体をグローバルにシーケンスします
建てる。 バリアント ビルドは、単一のソース ツリーから簡単に作成できます。 インテリジェントなビルド
ローカライズされた変更を行う場合、サブセット化が可能です。 オーバーライドを設定できます
スクリプトを変更することなく、ビルド手順を簡単にオーバーライドできます。 MD5 暗号化
署名 派生ファイルに関連付けられているかどうかを正確に判断するために使用されます。
特定のファイルを再構築する必要があります。

上記のすべてを提供しながら、短所はシンプルで使いやすいままです。 この意志、
願わくば、このドキュメントの残りの部分を読んで理解してください。

なぜ 短所？ なぜ 作る？

短所は make 置換。 次の段落では、いくつかの
make の望ましくない特性 (および make に基づく典型的なビルド環境)
Consの開発を動機付けました。

完成に向けてあなたの背中を押してくれる、執筆のための持続可能で本物のモーメンタムを作り出す。 複雑さ

あらゆる規模の従来のメークベースのシステムは、非常に複雑になる傾向があります。 オリジナルの作り
ユーティリティとその派生物は、さまざまな方法でこの傾向に貢献しています。 メイクは
複数のディレクトリに分散しているシステムを扱うのは苦手です。 いろいろな仕事――
この困難を克服するために、アラウンドが使用されます。 通常の選択は make を呼び出すことです
ビルドの各サブディレクトリに対して再帰的にそれ自体。 これは複雑なコードにつながります。
変数がどのように設定されるか、または変数の設定がどのような影響を与えるかが不明な場合が多い
ビルド全体に適用されます。 make スクリプト言語は徐々に拡張されています
より多くの可能性を提供するために
拡張された言語。 多くの場合、ビルドは複数のパスで実行されます。
適切な製品をあるディレクトリから別のディレクトリに移動します。 これはさらなる
ビルドの複雑さが増します。

完成に向けてあなたの背中を押してくれる、執筆のための持続可能で本物のモーメンタムを作り出す。 再現性

すべての make の悩みの種は、常に依存関係を正しく処理することでした。 ほとんどの場合、
単一のディレクトリ内で依存関係の合理的な仕事をしようとしますが、そうではありません
ディレクトリ間でジョブを実行するための真剣な試みが行われます。 依存関係がある場合でも
正しく動作するかどうかを判断するために、make は単純なタイム スタンプの比較に依存します。
ファイルがその従属ファイルに関して古くなっている場合、一般に、ファイルには適切ではありません。
ファイルをいつ再生成するかを決定します。 たとえば、外部ライブラリが
再構築されて「スナップ」されると、新しく作成されたファイルのタイムスタンプが
表示される前にビルドされたので、最後のローカル ビルドよりも前にある可能性があります。

バリアント 構築します

Make は、バリアント ビルドを処理するための限られた機能のみを提供します。 増殖とともに
ハードウェア プラットフォームの違いと、デバッグ可能なコードと最適化されたコードの必要性、
これらのバリアントを簡単に作成できることが不可欠です。 さらに重要なことは、バリアントが作成された場合、
バリアントを分離できるか、または再現できるかのいずれかが重要です。
自由にオリジナルまたはバリアント。 make を使用すると、ビルドを次のように分離することは非常に困難です。
ソースとは別の複数のビルド ディレクトリ。 そして、このテクニックを使わなければ、
また、どのバリアントが存在するかを常に保証することも事実上不可能です。
ツリーを完全に再構築する必要はありません。

リポジトリ

Make は、ファイルに存在するコードからソフトウェアを構築するための限定的なサポートのみを提供します。
中央リポジトリのディレクトリ構造。 GNU make の VPATH 機能 (およびその他の機能)
make implementations) はこれを提供することを目的としていますが、期待どおりに動作しません:
分析の早い段階でターゲット ファイルのパスを VPATH 名に変更するため、
VPATH ディレクトリ内のすべての依存関係を検索します。 正しく開発するために
ビルドの場合、ローカルのビルド ディレクトリにファイルを作成して、
ローカルに依存するコード リポジトリ (make 用語では VPATH ディレクトリ) 内のすべてのファイル
ファイルが適切に再構築されます。 これは、多くのコーディングを行わないと、VPATH では不可能です。
複雑なリポジトリの知識をメイクファイルに直接。

キーピング it シンプルな

make の難しさのいくつかは上で引用されています。 これ以降では
セクションでは、短所を紹介し、これらの問題にどのように対処するかを示します。

パール スクリプト

短所は Perl ベースです。 つまり、Cons スクリプトです。徴集兵 & 構築する ファイル、同等のもの
〜へ メークファイル or メイクファイル-- すべて Perl で書かれています。 これにより、すぐにメリットが得られます。
スクリプトを書くための言語はよく知られています。 あなたがたまたまPerlでなくても
プログラマーにとって、Perl は基本的に単純な宣言型言語であることを知っておくと役に立ちます。
明確に定義された制御フローと使い慣れたセマンティクスを備えています。 動作する変数があります
基本的には、サブルーチン、制御の流れなど、あなたが期待する方法です。 そこには
Cons に導入された特別な構文はありません。 スクリプト言語としての Perl の使用
しばしば複雑な問題に対する適切な解決策を表現するタスクを簡素化します
ビルドの要件。

こんにちは、 世界！

以下の議論の土台となるように、 こんにちは、 世界！ C
短所のあるアプリケーション:

$env = 新しいコンス();
プログラム $env 'hello', 'hello.c';

このスクリプトをディレクトリにインストールする場合は、スクリプトに名前を付けます。 構築する、を作成し、
こんにちはC ソース ファイルが同じディレクトリにある場合は、「cons hello」と入力してビルドできます。
アプリケーション：

% 短所こんにちは
cc -c こんにちは.c -o こんにちは.o
cc -o こんにちは hello.o

構造 環境

Cons の重要な単純化は、 建設 環境. 建設
環境は オブジェクト キーと値のペアのセットと 方法。
コンスに何かを構築する方法を伝えるために、適切なメソッドを
適切な建設環境。 次の例を検討してください。

$env = 新しいコンス(
CC => 'gcc',
ライブラリ => 'libworld.a'
);

プログラム $env 'hello', 'hello.c';

この場合、デフォルトのコンストラクション環境をそのまま使用するのではなく、
`CC' の値を上書きして、代わりに GNU C Compiler の等価物が使用されるようにしました。 以来
このバージョンの こんにちは、 世界！ ライブラリが必要です。 libworld.a、任意の
この環境でリンクされたプログラムは、そのライブラリとリンクする必要があります。 図書館なら
すでに存在しますが、そうでない場合は、次のステートメントも含める必要があります。

ライブラリ $env 'libworld', 'world.c';

ここで「cons hello」と入力すると、プログラムがリンクされる前にライブラリが構築されます。
もちろん、`gcc' は両方のモジュールをコンパイルするために使用されます:

% 短所こんにちは
gcc -c hello.c -o hello.o
gcc -c ワールド.c -o ワールド.o
a r libworld.a world.o
ar: libworld.a を作成しています
ranlib libworld.a
gcc -o こんにちは hello.o libworld.a

オートマチック & コンプリート 依存関係 分析

Cons を使用すると、依存関係が自動的に処理されます。 前の例を続けると、次のことに注意してください。
私たちが変更するとき world.c, 世界.o 再コンパイルされ、 libworld.a 再作成され、 こんにちは
再リンク:

% vi world.c
[編集]
% 短所こんにちは
gcc -c ワールド.c -o ワールド.o
a r libworld.a world.o
ar: libworld.a を作成しています
ranlib libworld.a
gcc -o こんにちは hello.o libworld.a

これは比較的単純な例です: Cons ``知っている'' 世界.o 依存する world.c、理由
依存関係は、`Library' メソッドによって明示的に設定されます。 それも分かっている libworld.a
依存する 世界.o その こんにちは 依存する libworld.a、すべて同様の理由で。

今、それが判明しました こんにちはC インターフェイス定義ファイルも含まれています。 world.h:

% emacs world.h
[編集]
% 短所こんにちは
gcc -c hello.c -o hello.o
gcc -o こんにちは hello.o libworld.a

コンスはどうやってそれを知っていますか こんにちはC 含ま world.h、その こんにちは。 したがって、
再コンパイル？ 今のところ、かどうかを考えるときは、 こんにちは。 起きている-
今日まで、コンスはその依存関係のためにスキャナーを呼び出します。 こんにちはC. このスキャナーは、
によって含まれるファイル こんにちはC それらを超えて、さらなる依存関係のリストを考え出す
Cons スクリプトによって明示されます。 このプロセスは再帰的です。
含まれているファイルもスキャンされます。

これは高くないですか？ 答えは、場合によります。 大規模システムのフルビルドを行う場合、
スキャン時間はわずかです。 大規模なシステムの再構築を行う場合、短所は
何もする必要がないと判断する前に、かなりの時間をかけてそれについて考えます
完了 (ただし、make よりも時間がかかるとは限りません!)。 良いニュースは、短所がそれを作ることです
ローカライズされた変更に取り組んでいるときに、ビルドをインテリジェントにサブセット化するのは非常に簡単です。

オートマチック 全体的な ビルド シーケンシング

コンスは完全かつ正確な依存関係分析を行い、これをグローバルに行うため、
コンスはこの情報を使用して、ビルド全体を完全に制御できます。 シーケンシング
ビルドの。 この順序付けは、上記の例で明らかであり、次のものと同等です。
依存関係の完全なセットを考えると、make に期待するでしょう。 短所があると、これは拡張されます
大規模なマルチディレクトリ ビルドに簡単に対応できます。 その結果、関連するすべての複雑さが
マルチパス階層を含む、ビルドが正しく編成されていることを確認する
builds -- は削除されます。 これについては、次のセクションでさらに説明します。

建物 大 木――まだ ただ as シンプルな

A 階層 of ビルド スクリプト

Cons のより大きなビルドは、次の階層を作成することによって編成されます。 ビルド スクリプト. 頂点で
ツリーのスクリプトは 構築する. 慣例により、残りのスクリプトはそれぞれ
呼ばれます 徴集兵. これらのスクリプトは、非常に単純に、「ビルド」によって相互に接続されています。
「エクスポート」および「インポート」コマンド。

　 完成に向けてあなたの背中を押してくれる、執筆のための持続可能で本物のモーメンタムを作り出す。 command

`Build' コマンドは、 徴集兵 ファイル名、およびそれらが
ビルドに含まれています。 例えば：

ビルド qw(
ドライバー/ディスプレイ/コンスクリプト
ドライバー/マウス/コンスクリプト
パーサー/コンスクリプト
公益事業/徴兵
);

これは、ビルド スクリプトの単純な XNUMX レベルの階層です。 徴集兵 ファイル
トップレベルで言及されている 構築する ファイル。 ツリー内のすべてのディレクトリではないことに注意してください
ビルド スクリプトが関連付けられている必要があります。

これは、マルチレベル スクリプトとして記述することもできます。 たとえば、 構築する ファイルかもしれない
次のコマンドを含めます。

ビルド qw(
パーサー/コンスクリプト
ドライバー/徴兵
公益事業/徴兵
);

と 徴集兵 内のファイル ドライバー ディレクトリにはこれが含まれている可能性があります：

ビルド qw(
表示/徴兵
マウス/徴兵
);

経験上、前のモデルの方が理解しやすいことがわかっています。
コンストラクション ツリー全体が目の前の最上位に配置されます。 ハイブリッドスキームは
可能です。 に組み込む必要がある、個別に維持されるコンポーネント
たとえば、ビルド ツリーは XNUMX か所でビルド ツリーにフックできますが、独自の定義を定義します。
構築階層。

デフォルトでは、Cons はその作業ディレクトリをファイルを含むディレクトリに変更しません。
子会社 徴集兵 それが含まれているファイル。 この動作は、ビルドに対して有効にすることができます
指定、トップレベル 構築する ファイル：

Conscript_chdir 1;

有効にすると、コンスは子会社に変わります 徴集兵 ファイルを含むディレクトリ
そのファイルを読み込んでいる間、ファイルが読み込まれたらトップレベルのディレクトリに戻ります
処理されました。

Cons の将来のバージョンでは、この動作がデフォルトになることが予想されます。
この移行に備えるために、コンスがビルドの最上位に留まることを期待するビルド
子会社で読み込み中 徴集兵 ファイルは、この機能を明示的に無効にする必要があります。
以下：

Conscript_chdir 0;

相対的、 上位相対、 & 絶対の file 名

Build コマンドに指定されたファイル名は、
呼び出されるスクリプトの場所。 これは通常、他のファイル名にも当てはまります
他のコマンドへの引数も同様です。
ファイル名にハッシュ記号「#」を付けた場合、そのファイルは先頭からの相対位置で解釈されます。
レベル ディレクトリ ( 構築する ファイルが存在します)。 そして、驚くことではありませんが、それを始めると
``/'' を使用すると、絶対パス名と見なされます。 これはシステム上でも当てはまります
スラッシュではなくバックスラッシュを使用して絶対パスに名前を付けます。

使い方 モジュール in ビルド スクリプト

モジュールをそれぞれにプルできます 徴集兵 通常の Perl の「use」または「require」を使用したファイル
文：

英語を使う;
My::モジュールが必要です。

それぞれの「use」または「require」は、XNUMX つだけに影響します。 徴集兵 表示されるファイル。 を使用するには
複数のモジュール 徴集兵 ファイルごとに「use」または「require」ステートメントを配置する必要があります
モジュールが必要なもの。

対象領域 of variables

トップレベル 構築する ファイルとすべて 徴集兵 ファイルは共通の個別の Perl で始まります
パッケージ。 デメリット パッケージのシンボル テーブルを制御して、そのシンボル テーブルを
を除いて、各スクリプトは空です。 構築する コマンドラインの一部を取得するファイル
引数。 したがって、設定または使用されるすべての変数は、スクリプトによって設定されます。
外部スクリプトによるものではありません。

変数は明示的に 輸入された 親スクリプトからのスクリプトによって。 をインポートするには
変数、だったに違いない 輸出された 親によって初期化されます (それ以外の場合はエラー
発生します）。

　 輸出 command

「エクスポート」コマンドは、次の例のように使用されます。

$env = 新しいコンス();
$INCLUDE = "#export/include";
$LIB = "#export/lib";
qw( env INCLUDE LIB ); をエクスポートします。
ビルド qw( util/Conscript );

「エクスポート」リストに記載されている単純な変数の値は、取り除かれます
後続の「ビルド」コマンドによって。 「エクスポート」コマンドは Perl のみをエクスポートします スカラー
つまり、名前が `$' で始まる変数です。 その他の変数、オブジェクトなど
参照によってエクスポートできますが、すべてのスクリプトは同じオブジェクトを参照します。
オブジェクトは、補助スクリプトおよび元のスクリプトによって読み取り専用であると見なされる必要があります。
スクリプトをエクスポートしています。 ただし、エクスポートされたスカラーに新しい値を割り当てることは許容されます
variable -- 参照される基になる変数は変更されません。 このシーケンスは、
例、OKです：

$env = 新しいコンス();
qw( env INCLUDE LIB ); をエクスポートします。
ビルド qw( util/Conscript );
$env = new cons(CFLAGS => '-O');
ビルド qw( other/Conscript );

変数が「エクスポート」コマンドの前または後に設定されているかどうかは問題ではありません。 の
重要なことは、`Build' コマンドが実行されたときの変数の値です。
これがリスを追い払うものです。 ちなみに、その後の「エクスポート」コマンドは、
最初の無効化: それぞれでエクスポートしたいすべての変数に言及する必要があります
「エクスポート」コマンド。

　 インポート command

「エクスポート」コマンドによってエクスポートされた変数は、
「インポート」コマンド。 補助スクリプトは常に変数を直接インポートします。
優れたスクリプト。 次の例を検討してください。

インポート qw( env INCLUDE );

これは、親スクリプトが `$env' と `$INCLUDE' の両方をエクスポートした場合にのみ有効です。 それはまたしなければならない
これらの変数値のそれぞれに与えられています。 サブスクリプトのみでもOK
エクスポートされた変数のサブセットをインポートします (この例では、によってエクスポートされた `$LIB'
前の例ではインポートされません)。

インポートされた変数はすべて自動的に再エクスポートされるため、シーケンスは次のようになります。

qw をインポートします ( env INCLUDE );
ビルド qw (underly-me/Conscript);

`$env' と `$INCLUDE' の両方を補助ファイルに提供します。 `$env' のみを指定する場合
エクスポートされた場合、次で十分です。

qw をインポートします ( env INCLUDE );
qw ( env ) をエクスポートします。
ビルド qw (underly-me/Conscript);

言うまでもなく、変数は、ビルドを実行する前にローカルで変更できます。
サブスクリプト。

完成に向けてあなたの背中を押してくれる、執筆のための持続可能で本物のモーメンタムを作り出す。 スクリプト 評価 注文

ビルド スクリプトの順序に関する唯一の制約は、上位のスクリプトが
下位スクリプトの前に評価されます。 トップレベル 構築する たとえば、ファイルは
最初に評価され、その後に下位のスクリプトが続きます。 これはあなたが本当に知る必要があるすべてです
評価の順序については、一般的に順序は無関係であるためです。 次のことを考慮してください
「ビルド」コマンド:

ビルド qw(
ドライバー/ディスプレイ/コンスクリプト
ドライバー/マウス/コンスクリプト
パーサー/コンスクリプト
公益事業/徴兵
);

スクリプト名をアルファベット順に並べることにしました。
メンテナンスに便利。 順番を変えても変わらない
ビルド。

A モデル for シェアリング ファイル

一部 シンプルな 規則

複雑なソフトウェア システムでは、ビルド プロダクトを共有する方法が必要です。
設立。 実装するのが簡単な単純な一連の規則を提案します
短所ですが、非常に効果的です。

基本的なルールは、共有する必要があるすべてのビルド製品を要求することです
ディレクトリは中間ディレクトリを介して共有されます。 私たちは通常、これを呼んでいます
export、および C 環境では、このディレクトリの従来のサブディレクトリを提供し、
など include, リブ, ビン, etc.

これらのディレクトリは、最上位の 構築する ファイル。 シンプルな 構築する ファイル
a こんにちは、 世界！ 複数のディレクトリを使用して編成されたアプリケーションは、次のようになります。

# Hello, World! のコンストラクト ファイル

# すべての共有製品をどこに置くか。
$EXPORT = '#エクスポート';

Export qw(CONS INCLUDE LIB BIN );

# 製品を共有するための標準ディレクトリ。
$INCLUDE = "$EXPORT/include";
$LIB = "$EXPORT/lib";
$BIN = "$EXPORT/ビン";

# 標準的な構築環境。
$CONS = 新しい短所 (
CPPPATH => $INCLUDE, # C コンパイルのインクルード パス
LIBPATH => $LIB, # プログラムをリンクするためのライブラリ パス
LIBS => '-lworld', # 標準ライブラリのリスト
);

ビルド qw(
こんにちは/徴兵
世界/徴兵
);

　 世界 ディレクトリの 徴集兵 ファイルは次のようになります。

# ディレクトリワールドのコンスクリプトファイル
import qw( CONS INCLUDE LIB );

# このディレクトリの製品をインストールします
$CONS $LIB, 'libworld.a' をインストールします。
$CONS $INCLUDE, 'world.h'; をインストールします。

# 内部製品
ライブラリ $CONS 'libworld.a', 'world.c';

と こんにちは ディレクトリの 徴集兵 ファイルは次のようになります。

# ディレクトリ hello のコンスクリプト ファイル
qw( CONS BIN ); をインポートします。

# 輸出製品
$CONS $BIN, 'hello'; をインストールします。

# 内部製品
プログラム $CONS 'hello', 'hello.c';

構築するには こんにちは、 世界！ このディレクトリ構造を持つプログラムで、最上位に移動します
ディレクトリに移動し、適切な引数を指定して「cons」を呼び出します。 次の例では、
Consにディレクトリを構築するように指示します export. ディレクトリを構築するために、Cons はすべてを再帰的に構築します。
そのディレクトリ内の既知の製品 (もちろん、再構築が必要な場合のみ)。 いずれかの場合
それらの製品は他のディレクトリ内の他の製品に依存しており、それらは構築されます。
のためにペンを持つ時間も見つけています。

% cons エクスポート
world/world.h を export/include/world.h としてインストールします。
cc -Iexport/include -c hello/hello.c -o hello/hello.o
cc -Iexport/include -c world/world.c -o world/world.o
a r world/libworld.a world/world.o
ar: world/libworld.a を作成しています
ranlib ワールド/libworld.a
world/libworld.a を export/lib/libworld.a としてインストールします。
cc -o こんにちは/こんにちは こんにちは/hello.o -Lexport/lib -lworld
hello/hello を export/bin/hello としてインストールします

掃除、 理解できる、 場所に依存しない スクリプト

この XNUMX つは 徴集兵 ファイルは非常にきれいで要点がはっきりしています。 彼らは単に
ディレクトリの製品とそれらの製品のビルド方法を指定します。 ビルド手順
最小限: 使用するコンストラクション環境、製品名、
および入力の名前。 スクリプトは場所に依存しないことにも注意してください。
ソース ツリーを再編成したい場合は、自由に変更できます。変更する必要があるのは、
構築する ファイル (この例では) を使用して、新しい場所を指定します。 徴集兵 ファイル。 ザ・
エクスポート ツリーを使用すると、この目標が容易になります。

また、Cons が細かな処理をどのように処理するかにも注目してください。 全ての export ディレクトリ、
たとえば、自動的に作成されました。 そして、インストールされたファイルは実際にハードリンクされていました
スペースと時間を節約するための、それぞれのエクスポート ディレクトリ。 細部へのこの注意は救います
シンプルで保守しやすいスクリプトの作成がさらに簡単になります。

分ける source & ビルド 木

多くの場合、ビルドからの派生ファイルを完全に分離しておくことが望ましいです。
ソースファイル。 これにより、ソースファイルが何であるかを追跡することがはるかに簡単になります.
また、取り扱いが簡単になります 異形 ビルド、特にバリアント ビルドが必要な場合
共存すること。

分ける ビルド & source ディレクトリ 　 リンク command

Cons は、これらすべての要件を処理する単純なメカニズムを提供します。 「リンク」
コマンドは、次の例のように呼び出されます。

Link 'build' => 'src';

指定されたディレクトリは、指定されたソース ディレクトリに「リンク」されます。 仮定しましょう
ソースディレクトリをセットアップし、 SRC、サブディレクトリとともに 世界 & こんにちは その下に、
前の例のように。 その後、元のビルドラインを置き換えることができます
次のとおりです。

ビルド qw(
ビルド/ワールド/コンスクリプト
ビルド/こんにちは/コンスクリプト
);

あなたが扱うことに注意してください 徴集兵 ビルド ディレクトリに存在するかのようにファイルを作成します。 今なら
前と同じコマンドを入力すると、次の結果が得られます。

% cons エクスポート
build/world/world.h を export/include/world.h としてインストールします。
cc -Iexport/include -c build/hello/hello.c -o build/hello/hello.o
cc -Iexport/include -c build/world/world.c -o build/world/world.o
a r build/world/libworld.a build/world/world.o
ar: build/world/libworld.a を作成しています
ranlib build/world/libworld.a
build/world/libworld.a を export/lib/libworld.a としてインストールします。
cc -o ビルド/hello/hello ビルド/hello/hello.o -Lexport/lib -lworld
build/hello/hello を export/bin/hello としてインストールします

繰り返しますが、Cons が詳細を処理してくれます。 特に、すべてのことに気付くでしょう。
ビルドは、ビルド ディレクトリのソース ファイルとオブジェクト ファイルを使用して行われます。 為に
例、 ビルド/ワールド/ワールド.o からコンパイルされます ビルド/ワールド/ワールド.c,
エクスポート/インクルード/world.h からインストールされます ビルド/ワールド/ワールド.h. これは、ほとんどの場合に達成されます
各ソースから必要なファイルを「ハード」リンクするという単純な手段によるシステム
ディレクトリを適切なビルド ディレクトリにコピーします。

ソースディレクトリに対して何をしても、リンクは Cons によって正しく維持されます。
ソースファイルを変更する場合、エディタはこれを「その場で」行うか、名前を変更する場合があります
最初に新しいファイルを作成します。 後者の場合、すべてのハード リンクが失われます。 短所は
次にソース ファイルが必要になったときにこの状態を検出し、再リンクします。
適切に。

ちなみに、次のことにも気付くでしょう。 いいえ 基礎に変更が必要でした 徴集兵
ファイル。 次のセクションで説明するように、さらに先に進むことができます。

バリアント 構築します

こんにちは、 世界！ for バナナ & 桃 OS

バリアント ビルドには、単純な拡張機能がもう XNUMX つ必要です。 例として
baNaNa と peAcH オペレーティング システムの両方のビルドを許可する必要があります。 この場合、
NFS などの分散ファイル システムを使用して特定のシステムにアクセスしている。
いずれかのシステムのみを特定の呼び出しに対してコンパイルする必要があります。
「短所」。 設定方法の XNUMX つを次に示します。 構築する 私たちのファイル こんにちは、 世界！
アプリケーション：

# Hello, World! のコンストラクト ファイル

$OS = $ARG{OS} でない限り、die qq(OS を指定する必要があります);
die qq(OSは「peach」か「banana」である必要があります)
if $OS ne "桃" && $OS ne "バナナ";

# すべての共有製品をどこに置くか。
$EXPORT = "#export/$OS";

Export qw(CONS INCLUDE LIB BIN );

# 製品を共有するための標準ディレクトリ。
$INCLUDE = "$EXPORT/include";
$LIB = "$EXPORT/lib";
$BIN = "$EXPORT/ビン";

# 標準的な構築環境。
$CONS = 新しい短所 (
CPPPATH => $INCLUDE, # C コンパイルのインクルード パス
LIBPATH => $LIB, # プログラムをリンクするためのライブラリ パス
LIBS => '-lworld', # 標準ライブラリのリスト
);

# $BUILD は、すべてを派生させる場所です。
$BUILD = "#build/$OS";

# $BUILD のソース ファイルがどこにあるかを cons に伝えます。
リンク $BUILD => 'src';

建てる （
"$BUILD/hello/Conscript",
"$BUILD/ワールド/コンスクリプト",
);

peAcH システムにログインすると、 こんにちは、 世界！ そのためのアプリケーション
プラットフォーム：

% cons エクスポート OS=peach
build/peach/world/world.h を export/peach/include/world.h としてインストールします。
cc -Iexport/peach/include -c build/peach/hello/hello.c -o build/peach/hello/hello.o
cc -Iexport/peach/include -c build/peach/world/world.c -o build/peach/world/world.o
a r build/peach/world/libworld.a build/peach/world/world.o
ar: build/peach/world/libworld.a を作成中
ranlib ビルド/ピーチ/ワールド/libworld.a
build/peach/world/libworld.a を export/peach/lib/libworld.a としてインストールします。
cc -o build/peach/hello/hello build/peach/hello/hello.o -Lexport/peach/lib -lworld
build/peach/hello/hello を export/peach/bin/hello としてインストールします

バリエーション on a テーマ

このモデルの他のバリエーションが可能です。 たとえば、
インクルード ファイルをプラットフォームに依存するファイルとプラットフォームに依存しないファイルに分けます。
この場合、プラットフォーム依存の $INCLUDE の代替を定義する必要があります。
ファイル。 多くの 徴集兵 純粋にプラットフォームに依存しないインクルード ファイルを生成するファイルは、
変更する必要はありません。

また、デバッグやプロファイリングを使用してシステム全体をコンパイルできるようにすることもできます。
たとえば、有効にします。 これは、次のような適切なコマンド ライン オプションを使用して行うことができます。
`DEBUG=オン'。 これは、適切なプラットフォーム固有の
デバッグを有効にするための要件 (これには、最適化をオフにすることが含まれる場合があります。
例）。 オプションで、これらの異なるタイプのシステムの名前空間を変えることができます。
しかし、次のセクションで説明するように、そうではありません 本質的な コンスはきれいなので、これを行うには
オプションを変更したときに物事を再構築するのが賢明です。

署名

MD5 暗号 署名

Cons が派生ファイルを作成するときはいつでも、 署名 そのファイルのために。 署名
ディレクトリごとに XNUMX つの別のファイルに格納されます。 前の例をコンパイルした後、
　 。委託 内のファイル ビルド/ピーチ/ワールド ディレクトリは次のようになります。

world.o:834179303 23844c0b102ecdc0b4548d1cd1cbd8c6
libworld.a:834179304 9bf6587fa06ec49d864811a105222c00

最初の数字はタイムスタンプです。UNIX システムの場合、これは通常、
1 年 1970 月 5 日からの秒数。XNUMX 番目の値は MDXNUMX チェックサムです。 の メッセージ ダイジェスト
アルゴリズム 入力文字列を指定して、強力な暗号を計算するアルゴリズムです。
その文字列の署名。 に格納されている MD5 チェックサム 。委託 ファイルは、事実上、
指定されたファイルのすべての依存関係情報のダイジェスト。 たとえば、
世界.o ファイル、これには少なくとも world.c ファイル、およびコンスするすべてのヘッダー ファイル
直接的または間接的に含まれていることを知っている world.c。 それだけでなく、
生成に使用された実際のコマンドライン 世界.o の計算にも供給されます
署名。 同様に、 libworld.a すべてを「含む」署名を取得します
その構成要素の署名 (したがって、推移的に、の署名 アプリ環境に合わせて
コンスティチュエント)、およびファイルを作成したコマンドライン。

非派生ファイルの署名は、デフォルトで、現在の
ファイルの変更時刻とファイルのエントリ名 (たまたま変更があった場合を除く)
現在 。委託 この場合、その署名が使用されます)。

派生ファイルが特定のファイルに依存する必要がないことに注意してください。 構築する or
徴集兵 file -- これらのファイルへの変更が問題のファイルに影響する場合、これは
コマンドラインの関連部分は
署名に含まれています。 無関係な変更は効果がありません。

Cons が特定のファイルを派生させるかどうかを検討するとき、まず、
ファイルの予想される署名。 次に、ファイルの最終変更時刻を比較します
に記録された時間 。委託 エントリ (存在する場合)。 これらの時間が一致する場合、
に保存されている署名 。委託 ファイルは正確であると見なされます。 ファイルが以前の場合
署名が新しい予想される署名と一致しない場合、ファイルを再生成する必要があります。

依存ファイルに関する何かが変更されるたびに、ファイルが再派生されることに注意してください。 の
特に、注意してください どれか 従属の変更時間への変更 (前方または
逆方向) は、派生ファイルの再コンパイルを強制します。

これらの署名の使用は、非常に単純で効率的かつ効果的な方法です。
システムの再現性を劇的に改善します。

簡単な例でこれを示します。

# シンプルな「Hello, World!」 構成ファイル
$CFLAGS = '-g' if $ARG{DEBUG} eq 'on';
$CONS = 新しいコンス(CFLAGS => $CFLAGS);
プログラム $CONS 'hello', 'hello.c';

Cons が適切なタイミングで再コンパイルされることに注意してください。

% 短所こんにちは
cc -c こんにちは.c -o こんにちは.o
cc -o こんにちは hello.o
% 短所こんにちは
短所：「こんにちは」は最新です。
% cons DEBUG=on こんにちは
cc -g -c ハロー.c -o ハロー.o
cc -o こんにちは hello.o
% cons DEBUG=on こんにちは
短所：「こんにちは」は最新です。
% 短所こんにちは
cc -c こんにちは.c -o こんにちは.o
cc -o こんにちは hello.o

Code リポジトリ

多くのソフトウェア開発組織には、XNUMX つ以上の中央リポジトリ ディレクトリがあります。
XNUMX つまたは複数のプロジェクトの現在のソース コードと派生したソース コードを含むツリー
オブジェクト ファイル、ライブラリ、および実行可能ファイル。 不要な再コンパイルを減らすために、
リポジトリのファイルを使用して開発ソフトウェアをビルドすると便利です。
もちろん、ローカル ビルド ツリーに新しい依存関係ファイルが存在しないことを確認してください。

倉庫

Cons は、検索されるコード リポジトリのリストを指定するメカニズムを提供します。
ローカル ビルド ディレクトリ ツリーに見つからないソース ファイルおよび派生ファイルの場合。

次の行 構築する ファイルは、コンスに最初に以下を調べるように指示します
/usr/実験/リポジトリ ディレクトリの下に /usr/製品/リポジトリ ディレクトリ：

リポジトリ qw (
/usr/実験/リポジトリ
/usr/製品/リポジトリ
);

指定されたリポジトリ ディレクトリには、ソース ファイル、派生ファイル (オブジェクト、
ライブラリと実行可能ファイル)、またはその両方。 下にローカル ファイル (ソースまたは派生) がない場合
Cons が実行されるディレクトリ、次に見つかった同じ名前のファイルの最初のコピー
リポジトリ ディレクトリの下にある は、ローカルの派生ファイルを構築するために使用されます。

Cons は、リポジトリ ディレクトリの XNUMX つのグローバル リストを維持します。 短所は、
現在のディレクトリ、および存在しないディレクトリをリストから削除します。

検索 　 構築する file in a 倉庫

短所も検索します 構築する & 徴集兵 リポジトリ ツリーまたはツリー内のファイル。
ただし、これはニワトリが先か卵が先かという状況につながります: リポジトリ ツリーをどのように見るか
のために 構築する ファイルの場合 構築する ファイルは、リポジトリがどこにあるかを教えてくれますか? 取得するため
これについては、コマンドラインで「-R」オプションを使用してリポジトリを指定できます。

% cons -R /usr/experiment/repository -R /usr/product/repository 。

で指定されたすべてのリポジトリ ディレクトリ 構築する or 徴集兵 ファイルが追加されます
コマンドラインの `-R' オプションで指定されたリポジトリ ディレクトリに。

倉庫 source ファイル

ソースコード（ 徴集兵 ファイル) のライブラリ バージョンの こんにちは、
世界！ C アプリケーションはリポジトリにあり (派生ファイルなし)、Cons は
リポジトリ ソース ファイルを使用して、ローカル オブジェクト ファイルと実行可能ファイルを作成します。

% cons -R /usr/src_only/repository こんにちは
gcc -c /usr/src_only/repository/hello.c -o hello.o
gcc -c /usr/src_only/repository/world.c -o world.o
a r libworld.a world.o
ar: libworld.a を作成しています
ranlib libworld.a
gcc -o こんにちは hello.o libworld.a

ローカル ソース ファイルを作成すると、Cons は適切な派生ファイルを再構築するか、
ファイル：

% ピコワールド.c
[編集]
% cons -R /usr/src_only/repository こんにちは
gcc -c ワールド.c -o ワールド.o
a r libworld.a world.o
ar: libworld.a を作成しています
ranlib libworld.a
gcc -o こんにちは hello.o libworld.a

また、ローカル ソース ファイルを削除すると、Cons は派生ファイルのビルドに戻ります。
リポジトリ ソースからのファイル:

% rm world.c
% cons -R /usr/src_only/repository こんにちは
gcc -c /usr/src_only/repository/world.c -o world.o
a r libworld.a world.o
ar: libworld.a を作成しています
ranlib libworld.a
gcc -o こんにちは hello.o libworld.a

倉庫 派生 ファイル

リポジトリ ツリーに派生ファイル (通常はオブジェクト ファイル、ライブラリ、または
実行可能ファイル)、Cons は通常の署名計算を実行して、
リポジトリ ファイルが最新であるか、派生ファイルをローカルでビルドする必要があります。 この意味は、
署名が正しく計算されるようにするには、リポジトリ ツリーに
。委託 派生ファイルを生成するときに Cons によって作成されたファイル。

これは通常、リポジトリでソフトウェアをビルドすることによって達成されます (または、
または、ビルド ディレクトリで、結果をリポジトリにコピーします):

% cd /usr/all/リポジトリ
% 短所こんにちは
gcc -c hello.c -o hello.o
gcc -c ワールド.c -o ワールド.o
a r libworld.a world.o
ar: libworld.a を作成しています
ranlib libworld.a
gcc -o こんにちは hello.o libworld.a

(これは、 構築する ファイルは /usr/all/リポジトリ のディレクトリ
「リポジトリ」コマンドは、Cons がリポジトリから現在のディレクトリを削除するためです。
リスト。）

独自のアプリケーションのコピーを作成したい場合 こんにちはC ファイル、必要なのは
XNUMX つの必要なソース ファイルを作成し、`-R' オプションを使用して、Cons に他のソース ファイルを使用させます。
リポジトリからのファイル:

% mkdir $HOME/build1
% cd $HOME/build1
%ed hello.c
[編集]
% cons -R /usr/all/repository こんにちは
gcc -c hello.c -o hello.o
gcc -o こんにちは hello.o /usr/all/repository/libworld.a

Cons はわざわざローカルを再作成していないことに注意してください。 libworld.a ライブラリ (または
世界.o モジュール) を使用しますが、代わりにリポジトリから既にコンパイルされたバージョンを使用します。

Cons が入れた MD5 署名は 。委託 ファイルには、
派生ファイルの場合、署名のタイムスタンプはファイルのタイムスタンプと一致する必要があります。
有効とみなされます。

一部のソフトウェア システムは、リポジトリ ファイルのタイムスタンプを変更する場合があります (それらをコピーして、
例) この場合、Cons はデフォルトで、リポジトリの署名が無効であると想定します。
不必要にファイルを再構築します。 この動作は、次を指定することで変更できます。

リポジトリ_Sig_Times_OK 0;

これは、署名が有効かどうかを判断するときにタイムスタンプを無視するように Cons に指示します。 （ノート
この健全性チェックを回避することは、リポジトリを適切に制御する必要があることを意味します
ツリーを更新せずに派生ファイルを変更できないようにします。 。委託
サイン。）

ローカル コピー of ファイル

リポジトリ ツリーにビルドの完全な結果が含まれている場合、そこからビルドしようとします。
ローカル ツリーにファイルのないリポジトリ。適度に驚くべきこと
起こる：

% mkdir $HOME/build2
% cd $HOME/build2
% cons -R /usr/all/repository こんにちは
短所：「こんにちは」は最新です。

なぜコンスは、 こんにちは 存在しない場合、プログラムは最新です こんにちは プログラムイン
ローカルビルドディレクトリ? リポジトリ (ローカル ディレクトリではない) には
最新 こんにちは プログラム、および Cons は何もする必要がないことを正しく判断します。
このファイルの最新のコピーを再構築します。

ただし、多くの場合、ローカル コピーの
ファイルは常に存在します。 たとえば、パッケージ化またはテスト スクリプトは、特定の
生成されたファイルはローカルに存在します。 これらの補助スクリプトを認識させる代わりに、
リポジトリ ディレクトリでは、「Local」コマンドを 構築する or 徴集兵 ファイルへ
特定のファイルがローカル ビルド ディレクトリに存在する必要があることを指定します。

ローカル qw(
こんにちは
);

次に、同じコマンドを再実行すると、Cons はプログラムのローカル コピーを作成します。
リポジトリのコピー (そうしていることを伝えます):

% cons -R /usr/all/repository こんにちは
/usr/all/repository/hello からの hello のローカル コピー
短所：「こんにちは」は最新です。

ローカル コピーを作成する行為は、
こんにちは ファイル、Cons はまだ最新であると報告しています。

ローカル コピーの作成は、
`Install' コマンドで中間ディレクトリ (他のディレクトリと共有するため)。
ファイルの `Install' コマンドに付随する `Local' コマンドを使用すると、
両方を行う便利な方法として、Cons が `Install_Local' コマンドを提供していることはよく知られています。

Install_Local $env, '#export', 'hello';

とまったく同じです：

インストール $env '#export', 'hello';
ローカル '#エクスポート/こんにちは';

「Local」コマンドと「Install_Local」コマンドはどちらもローカルを更新します 。委託 のファイル
今後のビルドが正しく実行されるように、適切なファイル署名。

倉庫 依存関係 分析

組み込みのスキャンにより、Cons は指定されたリポジトリ ツリーで含まれているものを検索します。
.h ファイル。 ただし、コンパイラがリポジトリ ツリーについても認識していない限り、
見つけることができません .h リポジトリにのみ存在するファイル。 たとえば、 こんにちはC
ファイルには こんにちは。 現在のディレクトリのファイル:

% cons -R /usr/all/repository こんにちは
gcc -c /usr/all/repository/hello.c -o hello.o
/usr/all/repository/hello.c:1: hello.h: そのようなファイルやディレクトリはありません

この問題を解決すると、建設環境のあり方にいくつかの要件が強制されます
ファイルをインクルードするために C の `#include' プリプロセッサ ディレクティブが使用されるように定義されています。

リポジトリ ツリーについてコンパイラに通知するために、Cons は適切な `-I' を追加します。
フラグをコンパイル コマンドに追加します。 これは、
コンストラクト環境では、検索するすべてのサブディレクトリを明示的に指定する必要があります
現在のディレクトリを含む、含まれるファイルの場合。 その結果、上記を修正できます
での環境作成の変更による例 構築する ファイルを次のようにします。

$env = 新しいコンス(
CC => 'gcc',
CPPPATH => '.',
LIBS => 'libworld.a',
);

`CPPPATH' 変数の定義により、これは、
コマンド：

% cons -R /usr/all/repository こんにちは
gcc -c -I。 -I/usr/all/repository /usr/all/repository/hello.c -o hello.o
gcc -o こんにちは hello.o /usr/all/repository/libworld.a

`-I' フラグの順序は、C プリプロセッサの場合、同じリポジトリを複製します。
Cons が独自の依存関係分析に使用するディレクトリ検索パス。 ある場合
複数のリポジトリと複数の「CPPPATH」ディレクトリ、コンスはリポジトリを追加します
ディレクトリを各 `CPPPATH' ディレクトリの先頭に移動し、その数を急速に増やします
`-I' フラグの。 極端な例として、 構築する 以下を含むファイル:

リポジトリ qw(
/ u1
/ u2
);

$env = 新しいコンス(
CPPPATH => 'a:b:c',
);

次のコンパイル コマンドが生成されます。

cc -Ia -I/u1/a -I/u2/a -Ib -I/u1/b -I/u2/b -Ic -I/u1/c -I/u2/c -c hello.c -oこんにちは。

Cons はコンパイラの `-I' フラグに依存して、
リポジトリディレクトリは検索する必要があります.Consのリポジトリディレクトリの扱いは
C の `#include' ディレクティブでの二重引用符の使用とは根本的に互換性がありません。
ソースコード：

#include "file.h" /* このような二重引用符は使用しないでください */

これは、ほとんどの C プリプロセッサが、このようなディレクティブに直面すると、常に最初に
ソースファイルを含むディレクトリを検索します。 これは精巧な `-I' を弱体化させます。
プリプロセッサを優先検索に適合させるために Cons が構築するオプション
パス。

したがって、Cons でリポジトリ ツリーを使用する場合、 常に 含まれるものには角かっこを使用します
ファイル：

＃含む/* 代わりに山括弧を使用 */

リポジトリ_リスト

Cons は、すべてのリポジトリ ディレクトリのリストを返す `Repository_List' コマンドを提供します。
現在の検索順序で。 これは、デバッグや、より複雑な Perl を実行するために使用できます。
もの：

@list = リポジトリ_リスト;
print join(' ', @list), "\n";

倉庫 相互作用 　 他の デメリット 機能を使用

Cons のリポジトリ ツリーの処理は、他の Cons 機能と正しく相互作用します。
つまり、一般的に期待どおりの動作をします。

最も顕著なのは、リポジトリ ツリーが「リンク」と正しく、かなり強力に相互作用することです。
指図。 リポジトリ ツリーには、バージョン ビルド用の XNUMX つ以上のサブディレクトリが含まれる場合があります
ソースサブディレクトリへの「リンク」を介して確立されます。 短所は派生ファイルを検索します
リポジトリ ツリーの下の適切なビルド サブディレクトリ。

デフォルト ターゲット

これまで、ビルドする明示的なターゲットを指定して Cons を呼び出す方法を示してきました。

% 短所こんにちは

通常、Cons はターゲットを指定しない限り何もビルドしませんが、'.' を指定します。
（現在のディレクトリ）はすべてを構築します：

% cons # 何もビルドしません

％短所。 # 最上位ディレクトリの下にすべてをビルドします

「デフォルト」メソッドを任意の 構築する or 徴集兵 ファイルは指定された
ターゲットをデフォルト ターゲットのリストに追加します。 ない場合、短所はこれらのデフォルトを構築します
コマンドラインで指定されたターゲット。 したがって、次の行をトップレベルに追加します
構築する ファイルは、デフォルトですべてをビルドする Make の典型的な動作を模倣します。

デフォルト '。';

以下は、 こんにちは & さようなら コマンド (コマンドと同じディレクトリ)
構築する or 徴集兵 ファイル) をデフォルトのリストに追加します。

デフォルト qw(
こんにちは
さようなら
);

「デフォルト」メソッドは、ターゲットをデフォルト リストに追加するために複数回使用できます。

選択的な 構築します

Cons は、特定のビルドのサイズを縮小するための XNUMX つの方法を提供します。 XNUMXつ目は、指定することです
XNUMX つ目は、ビルド ツリーをプルーニングする方法です。 良い
最初にターゲット仕様を検討してください。

選択的な ターゲット

make と同様に、Cons ではコマンドラインで「ターゲット」を指定できます。 短所の目標
ファイルまたはディレクトリのいずれかです。 ディレクトリが指定されている場合、これは単なる短いものです。
Consが知っているすべての派生製品の手書き表記は、指定された形式で
ディレクトリ以下。 例えば：

% cons build/hello/hello.o

ビルドを意味します こんにちは。 そしてそのすべて こんにちは。 必要があるかもしれません。 これは前作から
のバージョン こんにちは、 世界！ プログラム こんにちは。 に依存
エクスポート/インクルード/world.h. そのファイルが最新でない場合 (誰かが変更したため)
src/world/world.h)から離れたディレクトリにある場合でも、再構築されます。
ビルド/こんにちは.

この例では:

% コンスビルド

のすべて ビルド 必要に応じて、ディレクトリが構築されます。 繰り返しますが、これによりファイルが増える可能性があります
構築する。 特に、両方 エクスポート/インクルード/world.h & エクスポート/lib/libworld.a 　
によって必要とされる ビルド/こんにちは ディレクトリにあるため、それらが古くなっている場合はビルドされます。

その場合、代わりに:

% cons エクスポート

エクスポート ディレクトリにインストールする必要があるファイルのみが再構築されます。
し、そこにインストールします。 `cons build' は `cons
export' はビルドされず、その逆も同様です。

いいえ 「特別」 ターゲット

Cons を使用すると、make スタイルの「特別な」ターゲットは必要ありません。 短所のある最も単純なアナログ
特別に使うことです export 代わりにディレクトリ。 たとえば、あなたが持っているとしましょう
コードに関連付けられている一連の単体テスト全体。 テストは
コードの近くのソース ディレクトリ。 ただし、通常、これらのテストを作成する必要はありません。
XNUMX つの解決策は、テストを作成するためのすべてのビルド手順を提供してから、
テストをツリーの別の部分にインストールします。 テストをトップレベルにインストールすると
呼ばれるディレクトリ テスト、その後：

% cons テスト

すべてのテストをビルドします。

% cons エクスポート

システムの本番バージョンをビルドします (ただし、テストはビルドしません)。

% コンスビルド

おそらく避けるべきです (不必要にテストをコンパイルするため)。

XNUMX つのテストだけを作成する場合は、テストに明示的に名前を付けることができます (
どちらか テスト ディレクトリまたは ビルド ディレクトリ）。 テストを集約することもできます
tests ディレクトリ内の便利な階層に。 この階層は必要ありません
インクルード階層とほぼ同じ方法で、必ずソース階層と一致します。
ソース階層と一致しない可能性があります (インクルード階層がそれ以上になる可能性は低いです)
C プログラムの場合は XNUMX レベルより深い)。

ツリー内のすべてを絶対に構築したい場合 (どのようなオプションを選択しても
選択)、次を使用できます。

％短所。

これは、すべてのツリーを冗長にたどるので、特に効率的ではありません。
ソースツリーを含みます。 もちろん、ソース ツリーにはビルド可能なオブジェクトが含まれる場合があります。
それ-通常は別のビルドでビルドする場合でも、これを行うことを妨げるものは何もありません
ツリー。

完成に向けてあなたの背中を押してくれる、執筆のための持続可能で本物のモーメンタムを作り出す。 剪定

ターゲット選択と合わせて、 ビルド 剪定 の範囲を縮小するために使用できます。
建てる。 前の peAcH と baNaNa の例では、スクリプト駆動型の
ビルドのプルーニングを使用して、潜在的なビルドの半分だけを特定の目的で使用できるようにすることができます。
「cons」の呼び出し。 短所 また、便宜上、コマンド ライン規則を提供します。
を指定できます 徴集兵 ファイルは実際に「ビルド」されます。つまり、組み込まれます。
ビルドツリーに。 例えば：

% cons ビルド + ワールド

`+' 引数は、Perl 正規表現を導入します。 もちろん、これは次の場所で引用する必要があります。
式内にシェルのメタ文字がある場合は、シェル レベル。 の
式はそれぞれに対して照合されます 徴集兵 「ビルド」で言及されたファイル
名前が一致するスクリプトのみが実際に
ツリーを構築します。 複数のそのような引数が許可され、その場合、それらのいずれかと一致します
スクリプトを含めるには十分です。

上記の例では、 こんにちは Consには何もないので、プログラムはビルドされません
スクリプトの知識 こんにちは/徴兵を選択します。 libworld.a ただし、アーカイブは構築されます
する必要があります。

コマンド ラインによるビルドのプルーニングには、いくつかの用途があります。 おそらく最も有用な
ローカルな変更を行う能力であり、その後、
これらの変更の結果、高速化するためにビルド ツリーのサイズを制限します。
再構築時間。 ビルド プルーニングの XNUMX つ目の用途は、再コンパイルを積極的に防止することです。
たとえば、変更されたヘッダー ファイルが原因で再コンパイルされることがわかっている特定のファイル。
ヘッダー ファイルへの変更が重要ではないか、または
変更は、テスト目的で、ほとんどのツリーで安全に無視できます。
という理解のもとで、この種の行動を認めることが実際的であるという見解です。
次の完全なビルドでは、再構築する必要があるすべてのものになります。 同等のものはありません
ファイルを永久に最新のものとしてマークするために、「make touch」コマンドに。 したがって、あらゆるリスクは
ビルドのプルーニングによって発生する負荷が軽減されます。 リリース品質の作業については、明らかに、お勧めします
ビルドのプルーニングを使用しないこと (統合中に使用しても問題ありませんが、
コンパイルのチェックなど。コミットする前に、必ず制約のないビルドを実行してください。
統合）。

一時的な オーバーライド

Cons は、ビルドの側面をオーバーライドするための非常に単純なメカニズムを提供します。 本質は
XNUMX つまたは複数の「オーバーライド」コマンドを含むオーバーライド ファイルを作成し、
`cons' を実行するとき、コマンドラインでこれを指定します:

% cons -o over エクスポート

を構築します export ディレクトリ、存在するオーバーライドの対象となるすべての派生ファイル
セクションに が ファイル。 `-o' オプションを省略すると、削除に必要なすべてのものが削除されます。
すべてのオーバーライドが再構築されます。

オーバーライド 環境 variables

オーバーライド ファイルには、XNUMX 種類のオーバーライドを含めることができます。 XNUMXつ目は受信環境
変数。 これらは通常、 構築する `%ENV' ハッシュからのファイル
変数。 これらは、上書きファイルで簡単に上書きできます。
`%ENV' の適切な要素 (これらはユーザーの環境でオーバーライドされる可能性もあります。
もちろん）。

　 オーバーライド command

XNUMX 番目のタイプのオーバーライドは、次のような `Override' コマンドで実現されます。
この：

オーバーライド、 => 、 => 、...;

正規表現 正規表現 候補であるすべての派生ファイルに対して照合されます
ビルドのために。 派生ファイルが一致する場合、変数/値のペアが使用されます
派生ファイルに関連付けられたコンストラクション環境の値をオーバーライドします。

次のような構築環境があるとします。

$CONS = 新しいコンス(
COPT => '',
CDBG => '-g',
CFLAGS => '%COPT %CDBG',
);

次に、オーバーライドファイルがある場合 が このコマンドを含む：

オーバーライド '\.o$', COPT => '-O', CDBG => '';

次に、`-o over' を指定した `cons' 呼び出しが作成されます。 .o この環境を介したファイルは
`-O' を指定して `-g' を指定せずにコンパイルします。 もちろん、オーバーライドは
正規表現を適切に選択することにより、単一のディレクトリに制限されます。

これがHello, World!のオリジナルバージョンです。 この環境で構築されたプログラム。
オーバーライドが適用または削除されると、Cons は適切な部分を再構築することに注意してください。

% 短所こんにちは
cc -g -c ハロー.c -o ハロー.o
cc -o こんにちは hello.o
% cons -o over hello
cc -O -c こんにちは。c -o こんにちは。o
cc -o こんにちは hello.o
% cons -o over hello
短所：「こんにちは」は最新です。
% 短所こんにちは
cc -g -c ハロー.c -o ハロー.o
cc -o こんにちは hello.o

「Override」コマンドは一時的なオンザフライでのみ使用することが重要です
オーバーライドはプラットフォームに依存しないため、開発に必要なオーバーライド
スクリプトの動作に関する詳細な知識に頼りすぎているためです。 為に
一時的な使用ですが、まさにあなたが望むものです。

たとえば、完全に最適化された
本番用システムのバージョン -- から 構築する & 徴集兵 ファイル。 こちらです
最適化されたシステムをプラットフォームに合わせて調整できます。 オプティマイザーのトレードオフが必要な場所
作成されます (たとえば、特定のファイルは完全な最適化でコンパイルされない場合があります)。
これらは、後世 (および再現性) のためにスクリプトに直接記録できます。

その他 on 建設 環境

デフォルト 建設 variables

の概念について言及し、使用しました。 建設 環境、何度も
前のページ。 ここで、これをもう少し具体的にします。 以下で
ステートメント：

$env = 新しいコンス();

新しいデフォルト コンストラクション環境への参照が作成されます。 これには数字が含まれています
構成変数といくつかのメソッドの。 現時点では、デフォルトのリストは
構成変数は次のように定義されます。

CC => 'cc',
CFLAGS => '',
CCCOM => '%CC %CFLAGS %_IFLAGS -c %< -o %>',
INCDIRPREFIX => '-I',
CXX => '%CC',
CXXFLAGS => '%CFLAGS',
CXXCOM => '%CXX %CXXFLAGS %_IFLAGS -c %< -o %>',
リンク => '%CXX',
LINKCOM => '%LINK %LDFLAGS -o %> %< %_LDIRS %LIBS',
LINKMODULECOM => '%LD -r -o %> %<',
LIBDIRPREFIX => '-L',
AR => 'ar',
ARFLAGS => 'r',
ARCOM => "%AR %ARFLAGS %> %<\n%RANLIB %>",
RANLIB => 'RANLIB',
AS => 'as',
ASFLAGS => '',
ASCOM => '%AS %ASFLAGS %< -o %>',
LD => 'ld',
LDFLAGS => '',
PREFLIB => 'ライブラリ',
SUFLIB => '.a',
SUFLIBS => '.so:.a',
SUFOBJ => '.o',
ENV => { 'パス' => '/ binに:/ usr / bin' }、

Win32 システム (Windows NT) では、次の構築変数は
デフォルト：

CC => 'cl',
CFLAGS => '/nologo',
CCCOM => '%CC %CFLAGS %_IFLAGS /c %< /Fo%>',
CXXCOM => '%CXX %CXXFLAGS %_IFLAGS /c %< /Fo%>',
INCDIRPREFIX => '/I',
リンク => 'リンク',
LINKCOM => '%LINK %LDFLAGS /out:%> %< %_LDIRS %LIBS',
LINKMODULECOM => '%LD /r /o %> %<',
LIBDIRPREFIX => '/LIBPATH:',
AR => 'lib',
ARFLAGS => '/nologo',
ARCOM => "%AR %ARFLAGS /out:%> %<",
RANLIB => '',
LD => 'リンク',
LDFLAGS => '/nologo',
PREFLIB => '',
SUFEXE => '.exe',
SUFLIB => '.lib',
SUFLIBS => '.dll:.lib',
SUFOBJ => '.obj',

これらの変数は、環境に関連付けられたさまざまなメソッドによって使用されます。
特に、最終的に外部コマンドを呼び出すメソッドは、これらを置き換えます
必要に応じて、最終的なコマンドに変数を追加します。 たとえば、「オブジェクト」メソッドは
多数のソース ファイルと、必要に応じて、対応するオブジェクトの派生を手配します。
ファイル。 例えば：

オブジェクト $env 'foo.c', 'bar.c';

これにより、必要に応じて、 ふー。 & バーオー. 呼び出されるコマンドは単純です
必要な適切な外部コマンドに置換によって展開される `%CCCOM'
各オブジェクトを構築します。 「コマンド」の下で置換規則をさらに調べます。
メソッド、以下。

構築変数は他の目的にも使用されます。 たとえば、`CPPPATH' は
インクルード ディレクトリのパスをコロンで区切って指定するために使用されます。 これらは意図されています
C プリプロセッサに渡され、C ファイル スキャン機構によっても使用されます。
C コンパイルに含まれる依存関係を決定します。 で始まる変数
アンダースコアはさまざまな方法で作成され、通常は「内部」と見なされます。
変数。 たとえば、オブジェクトの作成を呼び出すメソッドが呼び出されたとき
C ソースから、変数 `_IFLAGS' が作成されます。これは `-I' スイッチに対応します。
`CPPPATH' で指定されたディレクトリを表すために C コンパイラで必要とされます。

特定の環境の場合、変数の値は一度設定され、その後で設定されることに注意してください。
リセットしない (変数を変更するには、新しい環境を作成する必要があります。メソッドが提供されています
この目的のために既存の環境をコピーする場合)。 次のようないくつかの内部変数
`_IFLAGS' はオンデマンドで作成されますが、一度設定されると、
環境。

`CFLAGS'、`LDFLAGS'、および `ARFLAGS' 変数はすべて、オプションを渡す場所を提供します。
それぞれ、コンパイラー、ローダー、およびアーカイバー。 それほど明白ではありませんが、`INCDIRPREFIX'
変数は、各インクルードの先頭に追加するオプション文字列を指定します
コンパイラがどこを見つけるかを知るためのディレクトリ .h ファイル。 同様に、
`LIBDIRPREFIX' 変数は、先頭に追加するオプション文字列を指定します
リンカーがライブラリを検索する必要がある各ディレクトリ。

別の変数「ENV」は、実行中のシステム環境を決定するために使用されます。
外部コマンドの。 デフォルトでは、設定されている唯一の環境変数は「PATH」です。
UNIX コマンドの実行パスです。 最大限の再現性を得るには、
トップレベルで、実際に独自の実行パスを設定するように手配します 構築する ファイル (または
おそらく、Perl の「use」コマンドで適切な構築パッケージをインポートすることによって)。 の
デフォルト変数は、すぐに使用できるようにすることを目的としています。

補間 建設 variables

コンストラクション環境変数は、ソース ファイル名とターゲット ファイル名で補間される場合があります
構築変数名の前に `%' を付けます。

$env = 新しいコンス(
DESTDIR => 'プログラム',
SRCDIR => 'src',
);
プログラム $env '%DESTDIR/hello', '%SRCDIR/hello.c';

構成変数の展開は再帰的です。つまり、ファイル 名(s) は再
置換ができなくなるまで拡張されます。 構成変数がそうでない場合
環境で定義されている場合、ヌル文字列が置き換えられます。

デフォルト 建設 メソッド

デフォルトの構築方法のリストには、次のものが含まれます。

　 「新しい」 コンストラクタ

`new' メソッドは Perl オブジェクト コンストラクタです。 つまり、参照を介して呼び出されません
既存の建設環境に 参照、しかし、かなり静的に、名前を使用して
パールの パッケージ コンストラクターが定義されている場所。 メソッドは次のように呼び出されます。

$env = 新しいコンス( );

戻ってきた環境は、パッケージ `cons' にブレスされています。
以下で説明するデフォルトのメソッドが関連付けられています。 個別施工
オーバーライド リストに名前と値のペアを指定することで、変数をオーバーライドできます。 ご了承ください
コマンド環境変数 (つまり、「ENV」の下にあるもの) をオーバーライドするには、次のようにする必要があります。
それらすべてをオーバーライドします。 この問題を回避するには、「copy」メソッドを
既存の建設環境。

　 「クローン」 方法

`clone' メソッドは、既存のコンストラクション環境のクローンを作成します。
次の例のように呼び出されます。

$env2 = $env1->clone( );

通常の方法でオーバーライドを提供して、別の環境を作成できます。
オリジナル。 同じ環境に新しい名前が必要な場合 (これは、
環境を既存のコンポーネントにエクスポートする場合)、単純な割り当てを使用するだけです。

　 「コピー」 方法

「copy」メソッドは、外部で定義された構成変数を
それらを名前と値のペアのリストとして返します。 オーバーライドも可能
その場合、必要に応じてオーバーライドされた値が返されます。 の
以下のプロトタイプに示すように、返されたリストをハッシュに割り当てることができますが、
他の方法で操作する:

%env = $env1->copy( );

それ自体がハッシュである「ENV」の値も新しいハッシュにコピーされるため、これは
元の環境に影響を与えることを恐れずに変更します。 たとえば、あなたが本当に
デフォルト環境で `PATH' 変数だけをオーバーライドしたい場合は、次のようにします。
次のとおりです。

%cons = new cons()->copy();
$cons{ENV}{PATH} = " ";
$cons = 新しい cons(%cons);

これにより、デフォルトの実行環境にある可能性のある他のものはすべて残されます
平静な。

　 「インストール」 方法

`Install' メソッドは、指定されたファイルが指定された場所にインストールされるように手配します。
ディレクトリ。 インストールは最適化されています。リンクできる場合、ファイルはコピーされません。 もしも
これは望ましい動作ではありません。別の方法でインストールする必要があります。
ファイル。 次のように呼ばれます。

$env をインストール、 ;

インストールされるファイルの名前は任意ですが、最後の
各名前のコンポーネントは、インストールされたターゲット名に使用されます。 たとえば、
インストールするように手配する foo / bar in バズ、これは バー 内のファイル バズ ディレクトリ（ではない
foo / bar).

　 「InstallAs」 方法

`InstallAs' メソッドは、指定されたソースを手配します file(s) としてインストールする
指定されたターゲット file（秒）。 複数のファイルをファイル リストとして指定する必要があります。 の
インストールが最適化されます。リンクできる場合、ファイルはコピーされません。 これが
必要な動作を行うには、別の方法を使用してファイルをインストールする必要があります。 それは
次のように呼ばれます：

`InstallAs' は XNUMX つの方法で動作します:

単一ファイルのインストール:

$env TgtFile、SrcFile としてインストールします。

複数ファイルのインストール:

InstallAs $env ['tgt1', 'tgt2'], ['src1', 'src2'];

または、次のようにも:

@srcs = qw(src1 src2 src3);
@tgts = qw(tgt1 tgt2 tgt3);
InstallAs $env [@tgts], [@srcs];

ターゲット リストとソース リストの両方が同じ長さである必要があります。

　 「貴重な」 方法

`Precious' メソッドは、指定されたファイルまたはファイルのリストを以前に削除しないように cons に要求します。
それらを再び構築します。 次のように呼び出されます。

貴重;

これは、ライブラリの増分更新やデバッグを許可する場合に特に便利です
毎回新しく再構築されるのではなく、更新される情報ファイル。 短所はまだ
`-r' フラグが指定されている場合、ファイルを削除します。

　 「コマンド」 方法

「コマンド」メソッドは、あらゆる外部コマンドを手配するために使用できるキャッチオール メソッドです。
ターゲットを更新するために呼び出されるコマンド。 このコマンドでは、ターゲット ファイルと
入力が提供されます。 さらに、構築コマンド ラインまたは複数のラインが、
文字列 (この文字列には、new で区切られた複数のコマンドが埋め込まれている場合があります
行）。 「コマンド」は次のように呼び出されます。

コマンド $env 、 、 ;

ターゲットは、指定された入力ファイルのリストに依存するようになり、入力は
そうしないと、Cons はターゲットのビルドを試行しません。

構築コマンド内では、構築環境からの任意の変数を
構成変数の名前の前に `%' を付けることで導入されます。 これは再帰的です:
コマンドは、置換ができなくなるまで展開されます。 建設であれば
variable が環境で定義されていない場合は、null 文字列が置き換えられます。 あ
二重化された `%%' は、構築コマンドで単一の `%' に置き換えられます。

展開される疑似変数がいくつかあります。

%> ターゲット ファイル名 (マルチターゲット コマンドでは、これは常に最初のターゲットです)
言及された）。

%0 `%>' と同じ。

%1、%2、...、%9
これらは、それぞれ XNUMX 番目から XNUMX 番目の入力ファイルを参照します。

%< 入力の完全なセット。 これらのいずれかが他の場所で使用されている場合
現在のコマンド ライン (`%1'、`%2' などを介して)、それらは
`%<' によって提供されるリスト。 で見つかった次のコマンドを検討してください 徴集兵 file
セクションに test ディレクトリ：

コマンド $env 'tgt', qw(foo bar baz), qq(
エコー %< -i %1 > %>
エコー %< -i %2 >> %>
エコー %< -i %3 >> %>
);

If tgt 更新する必要がある場合、これにより、
次のコマンドは、再マッピングが確立されていないと想定しています。 test
ディレクトリ：

エコー テスト/バー テスト/baz -i テスト/foo > テスト/tgt
echo test/foo test/baz -i test/bar >> test/tgt
echo test/foo test/bar -i test/baz >> test/tgt

上記の疑似変数のいずれかの直後に、次のいずれかが続く場合があります。
展開されたパス名の一部を選択するサフィックス:

:a ファイル名への絶対パス
:b ディレクトリに接尾辞を取り除いたファイル名を加えたもの
:d ディレクトリ
:f ファイル名
:s ファイル名のサフィックス
:F 接尾辞を取り除いたファイル名

上記の例を続けると、`%<:f' は `foo bar baz' に展開され、`%':d> は
「テスト」に展開します。

コマンドの一部を囲むことにより、プログラムでコマンドの一部を書き換えることができます
`%[' と `%]' の間。 これは、最初の単語として名前が付けられた構築変数を呼び出します
Perl コード参照として括弧で囲まれています。 この呼び出しの結果が使用されます
コマンドラインの括弧の内容を置き換えます。 たとえば、
という名前の既存の入力ファイル tgt.in:

@keywords = qw(foo bar baz);
$env = new cons(X_COMMA => sub { join(",", @_) });
コマンド $env 'tgt', 'tgt.in', qq(
echo '# キーワード: %[X_COMMA @keywords %]' > %>
猫 %< >> %>
);

これは実行されます：

echo '# キーワード: foo、bar、baz' > tgt
猫 tgt.in >> tgt

置換が行われた後、空白文字列は単一の空白に変換され、
先頭と末尾の空白は削除されます。 よって紹介不可
コマンドに渡される文字列内の可変長の空白。
一種のシェル引用。

複数行のコマンド文字列が指定されている場合、コマンドは順番に実行されます。 もしあれば
コマンドのうちの XNUMX つが失敗すると、残りのコマンドは実行されず、ターゲットは次のようにマークされません。
つまり、ターゲットの新しい署名は保存されません。

通常、すべてのコマンドが成功し、ゼロのステータスが返された場合 (またはプラットフォームが何であれ、
成功の特定の指示が必要)、新しい署名が保存されます。
目標。 コマンドが失敗した後でも誤って成功を報告した場合、Cons は次のことを行います。
そのコマンドによって作成されたターゲット ファイルが正確で最新のものであると想定します。

展開後の各コマンド文字列の最初の単語は、実行可能ファイルであると見なされます
コマンドは、'PATH' 環境変数 (これは、
「ENV」構成変数)。 このコマンドがパス上にある場合、ターゲットは
したがって、コマンドは必要に応じて自動的に構築されます。 これは
一部のシェルでは、セミコロンで区切られたマルチパート コマンドを記述できます。 のみ
ただし、最初のコマンドワードは依存するため、コマンド文字列を記述する場合
この方法では、(`Depends' メソッドを使用して) 依存関係を明示的に設定するか、または
使用しているコマンドがシステム コマンドであることを確認してください。
利用可能。 利用できない場合は、当然、エラーが発生します。

いずれかのコマンド (複数行のコマンド内の XNUMX つでも) が `[perl]' で始まる場合、残りは
そのコマンド ラインの
シェル。 Perl の解析中にエラーが発生した場合、または Perl 式が 0 または
undef の場合、コマンドは失敗したと見なされます。 たとえば、これは簡単です
Perl から直接ファイル `foo' を作成するコマンド:

$env = 新しいコンス();
コマンド $env 'foo',
qq([perl] open(FOO,'>foo');print FOO "hi\\n"; close(FOO); 1);

コマンドが実行されるとき、あなたは同じパッケージにいることに注意してください 構築する
or 徴集兵 ファイルが読み込まれたので、同じファイル内で定義した Perl 関数を呼び出すことができます
構築する or 徴集兵 「コマンド」が表示されるファイル:

$env = 新しいコンス();
サブ create_file {
私の $file = シフト;
open(ファイル、">$ファイル");
print FILE "hi\n";
close（FILE）;
1リターン;
}
コマンド $env 'foo', "[perl] &create_file('%>')";

Perl 文字列は、派生ファイルの署名を生成するために使用されます。
文字列を変更すると、ファイルが再構築されます。 呼び出すサブルーチンの内容、
ただし、署名の一部ではないため、次のような呼び出されたサブルーチンを変更すると
上記の `create_file' では、ターゲットは 再構築されます。 ユーザーに警告します。

Cons は通常、コマンドを実行する前に出力します。 この動作は、
コマンドの最初の文字は `@' です。 `@' を
コマンド名またはそれをエスケープして、`@cmd' が Perl の引用に配列のように見えないようにします
補間を実行する演算子:

# 最初のコマンド ラインが正しくありません。
# "@cp" は配列のように見えるため
# Perl qq// 関数に。
# 代わりに XNUMX 番目の形式を使用します。
コマンド $env 'foo', 'foo.in', qq(
@cp %< 一時ファイル
@ cp 一時ファイル %>
);

展開されたコマンド ラインのどこかに `<' などのシェル メタ文字がある場合、
`>'、引用符、またはセミコロンを使用すると、コマンドは実際に実行されます。
シェル。 これは、次のようなコマンドを意味します。

CD フー

パス上にコマンド `cd' がないため、単独では通常失敗します。 しかし、コマンド
文字列：

CD $<:d; tar cf $>:f $<:f

展開すると、シェルのメタ文字セミコロンが引き続き含まれ、シェルは
コマンドを解釈するために呼び出されます。 `cd' はこのサブシェルによって解釈されるため、コマンド
期待どおりに実行されます。

複数のターゲットを持つコマンドを指定するには、次のリストへの参照を指定できます。
ターゲット。 Perl では、リストを角括弧で囲むことによってリスト参照を作成できます。
したがって、次のコマンド：

コマンド $env ['foo.h', 'foo.c'], 'foo.template', q(
世代 %1
);

コマンド `gen' が XNUMX つのファイルを作成する場合に使用できます。 ふー。 & foo.c.

　 「オブジェクト」 方法

`Objects' メソッドは、指定されたオブジェクトに対応するオブジェクト ファイルを作成するように手配します。
ソースファイル。 以下に示すように呼び出されます。

@files = オブジェクト $env ;

Unix では、ソースファイルの末尾は .s & .c 現在サポートされており、コンパイルされる予定です
で終わる同じファイルの名前に .o. デフォルトでは、すべてのファイルは呼び出しによって作成されます
`CCCOM' 構成変数を展開した結果の外部コマンド。
`%<' と `%>' は、それぞれソース ファイルとオブジェクト ファイルに設定されます (`Command' メソッドを参照してください)。
拡張の詳細について)。 変数 `CPPPATH' は、ソース ファイルをスキャンするときにも使用されます
依存関係のために。 これはコロンで区切られたパス名のリストであり、作成にも使用されます
-`I' の適切なリストを含む構築変数 `_IFLAGS'
コンパイルのオプション。 `CPPPATH' 内の相対パス名はすべて相対パスとして解釈されます
関連付けられたコンストラクション環境が作成されたディレクトリ (絶対
および最上位の相対名も使用できます)。 この変数は「CCCOM」によって使用されます。 振る舞い
このコマンドの値は、補間される変数を変更することで変更できます
`CC' や `CFLAGS' などの `CCCOM' に、間接的には `CPPPATH' に。 することも可能です
`CCCOM' 自体の値を置き換えます。 便宜上、このファイルは次のリストを返します。
オブジェクトのファイル名。

　 「プログラム」 方法

「Program」メソッドは、指定されたプログラムを指定されたオブジェクトにリンクするように手配します
ファイル。 次の方法で呼び出されます。

プログラム $env 、 ;

プログラム名には、`SUFEXE' 構造変数の値が追加されます (
デフォルトでは、Win32 システムでは `.exe'、Unix システムでは何もありません) 接尾辞がまだない場合
プレゼント。

オブジェクトファイルの代わりにソースファイルを指定することができます -- `Objects' メソッドは
すべてのファイルをオブジェクト ファイルに変換するために呼び出されるため、すべての
上記の「オブジェクト」メソッドに関する観察は、このメソッドにも適用されます。

プログラムの実際のリンクは、外部コマンドによって処理されます。
オブジェクトファイルに設定された `%<' を使用して `LINKCOM' 構築変数を展開することから
(提示された順序で) リンクされ、`%>' がターゲットに設定されます (`Command' メソッドを参照してください)。
拡張の詳細について)。 ユーザーは、構造に追加の変数を設定できます
リンクに使用するプログラムを定義するための「LINK」を含む環境、「LIBPATH」、
のライブラリ仕様で使用するための、ライブラリ検索パスのコロンで区切られたリスト。
フォーム -llib、および `LIBS' で、リンクするライブラリのリストを指定します (いずれかで -llib
フォームまたは単にパス名として。 `LIBPATH' と `LIBS' の両方の相対パス名が解釈されます
関連付けられたコンストラクション環境が作成されたディレクトリに相対的
(絶対名と上位相対名も使用できます)。 短所は自動的に設定されます
`LIBS' に記述されているライブラリへの依存: これらのライブラリはビルド前にビルドされます。
コマンドがリンクされています。

　 「図書館」 方法

「Library」メソッドは、指定されたオブジェクトから指定されたライブラリを作成するように手配します
ファイル。 次のように呼び出されます。

ライブラリ $env 、 ;

ライブラリ名には、`SUFLIB' 構成変数の値が追加されます (
デフォルトでは、Win32 システムでは `.lib'、Unix システムでは `.a')、接尾辞がまだない場合
プレゼント。

オブジェクトファイルの代わりにソースファイルを指定することができます -- `Objects' メソッドは
すべてのファイルをオブジェクト ファイルに変換するために呼び出されるため、すべての
上記の「オブジェクト」メソッドに関する観察は、このメソッドにも適用されます。

ライブラリの実際の作成は、外部コマンドによって処理されます。
ライブラリメンバーに設定された `%<' を使用して、`ARCOM' 構築変数を展開することから (
提示された順序)、`%>' を作成するライブラリに指定 (`Command' メソッドを参照)
拡張の詳細)。 ユーザーはコンストラクション環境で変数を設定できます。
コマンドの動作に影響します。 これらには、使用するアーカイブプログラムである「AR」が含まれます。
ARFLAGS は、AR によって指定されたプログラムに与えられたフラグを変更するために使用できます。
必要に応じて、アーカイブ索引生成プログラムの名前である「RANLIB」(特定の
need が後者の機能を必要としない場合、`ARCOM' を再定義して、後者の機能を必要としないようにする必要があります。
`RANLIB' を参照)。

「Library」メソッドを使用すると、同じライブラリを複数のメソッドで指定できます
呼び出し。 すべての呼び出しからのすべての寄与オブジェクト (これは、
異なるディレクトリ) が結合され、単一のアーカイブ コマンドによって生成されます。 ノート、
ただし、ライブラリの一部のみが指定されるようにビルドを整理すると、
ライブラリのその部分が生成されます (残りは消えます!)。

　 「モジュール」 方法

「Module」メソッドは、「Program」メソッドと「Command」メソッドを組み合わせたものです。 それよりも
実行可能プログラムを直接生成する場合、このコマンドを使用すると、独自の
実際にモジュールを生成するコマンド。 メソッドは次のように呼び出されます。

モジュール $env 、 、 ;

このコマンドは、動的に作成する場合などに役立ちます。
読み込まれたモジュール、または静的にリンクされたコード ライブラリ。

　 「依存する」 方法

`Depends' メソッドを使用すると、ターゲットに追加の依存関係を指定できます。 それは
次のように呼び出されます。

$env に依存、 ;

これは、特にスキャナーが存在しない場合 (または存在する場合) に役立つ場合があります。
書き込み可能) 特定の種類のファイル用。 通常、依存関係は計算されます
メソッドによって設定された明示的な依存関係の組み合わせから自動的に
呼び出しまたはソース ファイルのスキャンによって。

複数のターゲットに対する同一の依存関係のセットは、への参照を使用して指定できます。
ターゲットのリスト。 Perl では、リストを四角で囲むことでリスト参照を作成できます。
ブラケット。 したがって、次のコマンド：

依存 $env ['foo', 'bar'], 'input_file_1', 'input_file_2';

両方の foo & バー ファイルは、リストされた入力ファイルに依存します。

　 「無視する」 方法

`Ignore' メソッドを使用すると、Cons が推論する依存関係を明示的に無視できます。
自分の。 次のように呼び出されます。

無視;

これは、システム ヘッダー ファイルの変更による再コンパイルを回避するために使用できます。
生成されたターゲットに影響を与えないことが知られているユーティリティ。

たとえば、プログラムが複数のシステム上の NFS マウントされたディレクトリに構築されている場合、
の異なるコピーを持つ stdio.h、違いはすべての署名に影響します
`#include を含むソース ファイルから構築された派生ターゲット'。 これがすべての原因になります
システムを変更するときに、それらのターゲットを再構築する必要があります。 これが望ましくない動作である場合は、
次に、次の行で依存関係を削除します stdio.h ファイル：

'^/usr/include/stdio\.h$' を無視します。

`Ignore' メソッドの引数は正規表現であるため、特別なものであることに注意してください。
文字はエスケープする必要があり、文字の先頭または末尾を固定したい場合があります。
`^' または `$' 文字を使用した式。

　 「塩」 方法

「Salt」メソッドは、導出されたすべての署名計算に定数値を追加します
ファイル。 次のように呼び出されます。

ソルト $string;

Salt 値を変更すると、すべての派生ファイルが完全に再構築されます。 これはすることができます
特定の必要な状況で再構築を強制するために使用されます。 例えば、

`uname -s` をソルトします。

オペレーティング システムがオンの場合は常に、すべての派生ファイルの完全な再構築を強制します。
ビルドが実行される (「uname -s」によって報告される) 変更。

　 「UseCache」 方法

`UseCache' メソッドは、共有される派生ファイルのキャッシュを保持するよう Cons に指示します。
同じプロジェクトの別々のビルド ツリー間。

UseCache("キャッシュ/ ") ⎪⎪ warn("キャッシュディレクトリが見つかりません");

　 「ソースパス」 方法

`SourcePath' メソッドは、ファイルの実際のソース パス名を返します。
ビルド ディレクトリ内のパス名。 次のように呼び出されます。

$path = ソースパス;

　 「コンパス」 方法

`ConsPath' メソッドは、指定されたパスが派生ファイルである場合に true を返し、
それ以外の場合は undef (false)。 次のように呼び出されます。

$result = ConsPath ;

　 「分割パス」 方法

`SplitPath' メソッドは、デフォルトで区切られた文字列で複数のパス名を検索します。
オペレーティング システムのパス セパレータ (UNIX システムでは「:」、Windows NT では「;」)、および
完全修飾名を返します。 次のように呼び出されます。

@paths = スプリットパス;

`SplitPath' メソッドは、'#' で始まる名前を適切なトップレベル ビルドに変換します。
名前 ('#' なし) を使用し、相対名をトップレベル名に変換します。

　 「DirPath」 方法

`DirPath' メソッドはビルド パスを返します 名(s) ディレクトリまたはディレクトリのリスト。
次のように呼び出されます。

$cwd = DirPath ;

DirPath メソッドの最も一般的な用途は次のとおりです。

$cwd = DirPath '.';

子会社の現在のディレクトリへのパスを取得する 徴集兵 ファイルにソフトウェアを指定する必要があります。

　 「ファイルパス」 方法

`FilePath' メソッドはビルド パスを返します 名(s) ファイルまたはファイルのリスト。 それは
次のように呼び出されます。

$file = ファイルパス;

　 「助けて」 方法

「Help」メソッドは、ユーザーが「cons」を呼び出したときに表示されるヘルプ テキストを指定します。
-h'. これは、特定のターゲット、値、ビルドのドキュメントを提供するために使用できます。
ビルドツリーのオプションなど。 次のように呼び出されます。

ヘルプ;

「Help」メソッドは XNUMX 回だけ呼び出すことができ、通常は先頭で指定する必要があります。
レベル 構築する ファイルにソフトウェアを指定する必要があります。

拡張 デメリット

オーバーライド 建設 variables

Cons を拡張するにはいくつかの方法があり、難易度が異なります。 最も簡単な
メソッドは、デフォルトの環境に基づいて、独自の構築環境を定義することです。
ただし、特定のニーズを反映するように変更されています。 多くの場合、C ベースの場合はこれで十分です。
アプリケーション。 `new' コンストラクタと `clone' および `copy' メソッドを使用して、
ハイブリッド環境を作成します。 これらの変更は、基礎となるものに対して完全に透過的です。
徴集兵 ファイル。

追加 新製品 メソッド

もう少し厳しい変更が必要な場合は、`cons' に新しいメソッドを追加することをお勧めします。
パッケージ。 これは非常に単純な拡張機能の例です。
要求された場所にある tcl スクリプトですが、最初にスクリプトを編集してプラットフォームを反映します。
スクリプトにインストールする必要がある依存パス:

# cons::InstallScript - シェルのプラットフォーム依存バージョンを作成する
# 文字列 ``#!your-path-here'' をプラットフォーム固有のものに置き換えたスクリプト
# パス $BIN_DIR.

サブコン::InstallScript {
私の ($env, $dst, $src) = @_;
コマンド $env $dst, $src, qq(
sed s+your-path-here+$BIN_DIR+ %< > %>
chmod oug+x %>
);
}

このメソッドは `cons' パッケージで直接定義されていることに注意してください (名前の前に
`cons::' を使用)。 この方法で行われた変更は、すべての環境でグローバルに表示されます。
次の例のように呼び出すことができます。

InstallScript $env "$BIN/foo", "foo.tcl";

一般性を少し改善するために、`BINDIR' 変数を
引数または構築環境から取得された -- `%BINDIR' として。

オーバーライド メソッド

メソッドを「cons」名前空間に追加する代わりに、新しいパッケージを定義できます
`cons' パッケージから既存のメソッドを継承し、他のメソッドをオーバーライドまたは追加します。 これ
Perl の継承メカニズムを使用して実行できます。

次の例では、標準をオーバーライドする新しいパッケージ `cons::switch' を定義しています。
「ライブラリ」メソッド。 オーバーライドされたメソッドは、ライブラリではなく、リンクされたライブラリ モジュールをビルドします
アーカイブ。 新しいコンストラクタが提供されます。 このコンストラクターで作成された環境は、
新しいライブラリ メソッドがあります。 他の人はしません。

パッケージの短所::スイッチ;
BEGIN {@ISA = '短所'}

サブニュー{
シフト;
新しいコンス(@_)を祝福します。
}

サブライブラリ {
my($env) = シフト;
my($lib) = シフト;
my(@objs) = オブジェクト $env @_;
コマンド $env $lib, @objs, q(
%LD -r %LDFLAGS %< -o %>
);
}

この機能は、次の例のように呼び出すことができます。

$env = 新しい cons::switch(@overrides);
...
ライブラリ $env 'lib.o', 'foo.c', 'bar.c';

呼び出す デメリット

`cons' コマンドは通常、ビルド ツリーのルートから呼び出されます。 あ 構築する file
そのディレクトリに存在する必要があります。 `-f' 引数が使用されている場合、代替 構築する
file を使用することができます (そして、`cons' が cd するため、おそらく代替ルートも使用できます)。 構築する
ファイルを含むディレクトリ)。

`cons' がビルド ツリーのルートの子から `-t' 引数で呼び出されると、
ディレクトリ階層を上って、 構築する ファイル。 (別の名前でも構いません
コマンドラインで指定されたターゲットは変更されます。
発見されたものに関連する 構築する ファイル。 たとえば、次を含むディレクトリから
トップレベル 構築する ファイル、次の呼び出し:

% cd libfoo/サブディレクトリ
% cons -t ターゲット

とまったく同じです：

% cons libfoo/subdir/target

ディレクトリ階層に「デフォルト」ターゲットが指定されている場合 構築する or
徴集兵 `cons -t' を実行したディレクトリ以下のデフォルトのターゲットのみ
呼び出されたものがビルドされます。

コマンドは次のように呼び出されます。

短所--

コラボレー 引数 次のいずれかを任意の順序で指定できます。

ターゲット 指定されたターゲットをビルドします。 もしも ターゲット ディレクトリである場合、再帰的にビルドします
そのディレクトリ内のすべて。

+パターン 制限する 徴集兵 一致するものだけと見なされるファイル パターンボタンの隣にある
Perl の正規表現。 複数の `+' 引数が受け入れられます。

名=
セット 名 貴ぶ ヴァル トップレベルに渡される「ARG」ハッシュで 構築する ファイルにソフトウェアを指定する必要があります。

`-cc' キャッシュから取得するときに実行されるコマンドを表示します。 いいえ
ファイルが取得されたことが示されます。 これは便利です
実際のビルド ログと比較できるビルド ログを生成します。

`-cd' すべてのキャッシングを無効にします。 キャッシュから取得したり、キャッシュにフラッシュしたりしません。

`-cr' 依存関係をランダムな順序で構築します。 これは、複数構築する場合に便利です。
キャッシュが有効になっている同様のツリー。

`-cs' 最新であることが判明した既存のビルド ターゲットをキャッシュと同期します。
これは、キャッシュが -cc で無効になっている場合、または最近有効になったばかりの場合に役立ちます。
UseCache を使用します。

`-d' 依存関係のデバッグを有効にします。

`-f'
の代わりに指定されたファイルを使用します。 構築する (しかし、最初に包含に変更
のディレクトリ file).

`-h' 現在のビルドにローカルなヘルプ メッセージが定義されている場合は、そのヘルプ メッセージを表示して終了します。

`-k' エラーの後、可能な限り続行します。

「-o」
上書きファイルを読む file.

`-p' 指定されたツリーの建設製品を表示します。 ビルドは試行されません。

`-pa' コンストラクション プロダクトと関連するアクションを表示します。 ビルドは試行されません。

`-pw' 製品とそれらが定義されている場所を表示します。 ビルドは試行されません。

`-q' ターゲットのインストールと削除について冗長にならないようにします。

`-r' 関連する建設製品を削除します. ビルドは試行されません。

`-R'
でファイルを検索 休息。 複数 -R 休息 ディレクトリは
指定された順序。

`-t' ディレクトリ階層を上に移動して、 構築する ファイルが存在しない場合
現在のディレクトリに。 ターゲットは、
構築する ファイルにソフトウェアを指定する必要があります。

`-v' `cons' バージョンを表示し、処理を続行します。

`-V' `cons' バージョンを表示して終了します。

`-wf'
考慮されたすべてのファイル名を file.

`-x' このようなヘルプメッセージを表示して終了します。

構成引数 で処理したい任意の引数にすることができます 構築する ファイルにソフトウェアを指定する必要があります。
あるべきであることに注意してください -- 引数をコンスに分離し、引数を
で処理したい 構築する ファイルにソフトウェアを指定する必要があります。

の処理 構成引数 次のような標準パッケージで実行できます ゲトップト またはその
バリアント、または任意のユーザー定義パッケージ。 短所 で通過します 構成引数 as @ARGV &
の後に何も解釈しようとしません。 --.

% cons -R /usr/local/repository -d os=solaris +driver -- -c test -f DEBUG

以下を cons に渡します

-R /usr/local/repository -d os=solaris +ドライバー

そして、トップレベルまで 構築する ファイルとして @ARGV

-c テスト -f デバッグ

「cons -r」に注意してください。 完全な再帰的な `make clean' と同等ですが、何も必要ありません
でのサポート 構築する ファイルまたは任意 徴集兵 ファイル。 これは、次の場合に最も役立ちます。
ファイルをソース ディレクトリにコンパイルします ( ビルド & export ディレクトリ、
その後、ディレクトリを削除できます）。

オプション `-p'、`-pa'、および `-pw' は、読書の補助として使用するのに非常に役立ちます。
スクリプトまたはそれらのデバッグ。 インストールするスクリプトを知りたい場合 エクスポート/インクルード/foo.h,
たとえば、次のように入力します。

% cons -pw エクスポート/インクルード/foo.h

使い方 & 書き込み 依存関係 スキャナ

QuickScan を使用すると、ターゲットに依存しないシンプルなスキャナーをソース ファイル用にセットアップできます。 それだけ
XNUMX つの QuickScan スキャナーを任意のソース ファイルおよび環境に関連付けることができます。

QuickScan は次のように呼び出されます。

QuickScan CONSENV CODEREF、ファイル名 [、パス]

CODEREF によって参照されるサブルーチンは、含まれるファイル名のリストを返すことが期待されています
FILE で直接。 次に、これらのファイル名がスキャンされます。 オプションの PATH 引数
ユーザー提供の
サブルーチン。 PATH は、ルックアップ ディレクトリ名の配列への参照、または
システムの区切り文字 (UNIX システムでは「:」、システムでは「;」) で区切られた名前の文字列
Windows NT）。

サブルーチンは、ファイルの各行に対して XNUMX 回呼び出され、$_ が現在の行に設定されます。
サブルーチンが追加の行、さらに言えばファイル全体を調べる必要がある場合は、
次に、ファイルハンドル SCAN からそれら自体を読み取ることができます。 次の場合、ループを終了することもあります。
ファイルハンドルを閉じることにより、これ以上インクルード情報が利用できないことがわかります。

検索パスが指定されているかどうかに関係なく、QuickScan は最初にファイルの検索を試みます。
現在のディレクトリからの相対パス (QuickScan に直接提供される最上位ファイルの場合)、
または、ファイルを参照したファイルを含むディレクトリから。 これはあまりない
一般的ですが、特に自分で書く余裕がある場合は十分に良さそうです
ユーティリティであり、標準的な方法で検索パスの使用を制御できます。 最後に、
現在、検索パスはコロンで区切られています。 これでは、NT 陣営は満足できないかもしれません。

これは実際の例です。 構築する ここにファイル：

サブコン::SMFgen {
my($env, @tables) = @_;
foreach $t (@tables) {
$env->QuickScan(sub { /\b\S*?\.smf\b/g }, "$t.smf",
$env->{SMF_INCLUDE_PATH});
$env->コマンド(
["$t.smdb.cc","$t.smdb.h","$t.snmp.cc","$t.ami.cc", "$t.http.cc"],
"$t.smf",
q(
smfgen %( %SMF_INCLUDE_OPT %) %
)
);
}
}

[`$env->QuickScan ...' および `$env->Command ...' の形式は使用しないでください。
必要ですが、何らかの理由で、この特定の呼び出しに必要です。 これが現れます
Perl のバグか、私の誤解です。 この呼び出しスタイルは
常に必要と思われる。]

これにより、フォームのすべての名前が検索されますファイル内の .smf。 場合でも名前を返します
それらはコメント内にありますが、問題ありません (メカニズムは余分なファイルを許容します。
それらは、ファイルが見つからないときに気付かれるという前提で単に無視されます。
プログラム (この例では smfgen) が実際に呼び出されます)。

スキャナーは、特定のソース ファイルに対してのみ呼び出されます。
木。 これは、特定のソース ファイルに対して XNUMX 回だけ呼び出されます。

同じスキャナーを構築する別の方法を次に示します。 これは明示的なコード参照を使用しており、
また、（この場合は不必要に）ファイル全体を読み取ります。

サブマイスキャン{
私の（@含む）;
する
プッシュ (@includes, /\b\S*?\.smf\b/g);
} その間;
@含む
}

ループの順序が逆になり、ループ テストが最後になることに注意してください。 これは
最初の行はすでに読み取られているためです。 このスキャナはソースに接続できます
ファイル:

QuickScan $env \myscan, "$_.smf";

サポート そして 提案

短所は、ユーザー コミュニティによって維持されます。 購読するには、にメールを送信してください 短所-議論-
[メール保護] 体で 申し込む.

から提案を報告してください [メール保護] メーリングリスト。

onworks.net サービスを使用してオンラインでコンスを使用する