最新のソース配布物はアーカイブとしてダウンロードできます。

pugixml-1.16.zip（Windows形式の改行） / pugixml-1.16.tar.gz（Unix形式の改行）

配布物には、ライブラリのソース、文書（今読んでいるこのマニュアルとクイックスタートガイド）、コード例が含まれています。配布物をダウンロードしたら、圧縮アーカイブ内のすべてのファイルを展開してpugixmlをインストールしてください。

古い版が必要な場合は、バージョンアーカイブからダウンロードできます。

Gitリポジトリはhttps://github.com/zeux/pugixml/にあります。各バージョンにはGitタグ"v{version}"があり、常に最新の安定版リリースを指す"latest"タグもあります。

たとえば、現在の版をチェックアウトするには、次のコマンドを使えます。

リポジトリには、ライブラリのソース、文書、コード例、完全な単体テストスイートが含まれています。

新しい版を自動的に取得したい場合はlatestタグを使ってください。明示的な操作でのみ新しい版へ切り替えたい場合は、ほかのタグを使ってください。また、masterブランチには開発途中のコードが含まれていることに注意してください。新しいリリースを待たずにmasterから新機能やバグ修正を取得できる一方、構成によってはコードが動作しなくなることもあります。

pugixmlは、各種パッケージマネージャーを通じてパッケージとして入手できます。ほとんどのパッケージはメインリポジトリとは別に保守されているため、必ずしも最新の版を含んでいません。

各種システムのpugixmlパッケージの例を挙げます。これは網羅的な一覧ではありません。

pugixmlをビルドする最も簡単な方法は、ソースファイルpugixml.cppを既存のライブラリや実行ファイルと一緒にコンパイルすることです。この手順はアプリケーションのビルド方法によって異なります。たとえばMicrosoft Visual Studio ^[1]、Apple Xcode、Code::Blocks、その他のIDEを使っている場合は、いずれかのプロジェクトにpugixml.cppを追加するだけです。

Microsoft Visual Studioを使っていて、プロジェクトでプリコンパイル済みヘッダーが有効になっていると、次のエラーメッセージが表示されます。

正しい解決方法は、pugixml.cppについてプリコンパイル済みヘッダーを無効にすることです。"Create/Use Precompiled Header"オプション（Propertiesダイアログ → C/C++ → Precompiled Headers → Create/Use Precompiled Header）を"Not Using Precompiled Headers"に設定してください。すべてのプロジェクト構成・プラットフォームについて設定する必要があります。オプションを編集する前に、Configurationで"All Configurations"、Platformで"All Platforms"を選択できます。

pugixmlを独立した静的ライブラリとしてコンパイルすることもできます。この手順はアプリケーションのビルド方法によって異なります。pugixmlの配布物には、よく使われるいくつかのIDE・ビルドシステム用のプロジェクトファイルが付属しています。Apple XCode、Code::Blocks、Codelite、Microsoft Visual Studio 2005、2008、2010以降用のプロジェクトファイルと、CMakeおよびpremake4用の設定スクリプトがあります。ほかのソフトウェア用のプロジェクトファイルやビルドスクリプトの提出も歓迎します。フィードバックを参照してください。

Microsoft Visual Studioの各版には2つのプロジェクトがあります。1つはpugixml_vs2008.vcprojのような名前の、CRTを動的にリンクするものです。もう1つはpugixml_vs2008_static.vcprojのような名前の、CRTを静的にリンクするものです。アプリケーションで使うCRTと一致する方を選択してください。Microsoft Visual Studioで作成した新規プロジェクトの既定値は、CRTの動的リンクです。そのため、既定値を変更していなければ動的CRT版を使ってください。たとえばMicrosoft Visual Studio 2008ではpugixml_vs2008.vcprojです。

pugixmlプロジェクトをワークスペースへ追加するだけでなく、アプリケーションがpugixmlライブラリとリンクすることも確認する必要があります。Microsoft Visual Studio 2005/2008の場合は、アプリケーションのプロジェクトからpugixmlプロジェクトへの依存関係を追加できます。Microsoft Visual Studio 2010以降の場合は、代わりにアプリケーションのプロジェクトへ参照を追加する必要があります。ほかのIDEやシステムについては、それぞれの文書を参照してください。

pugixmlを独立した共有ライブラリとしてコンパイルすることもできます。手順は通常、静的ライブラリの場合と似ています。ただし、pugixmlの配布物には設定済みのプロジェクトやスクリプトが含まれていないため、自分で用意する必要があります。一般に、GCCベースのツールチェーンでは、ほかのライブラリをDLLとしてビルドする場合と違いはありません。コンパイルフラグに-sharedを追加すれば十分です。MSVCベースのツールチェーンでは、エクスポートするシンボルをdeclspec属性で明示的に指定する必要があります。PUGIXML_APIマクロを、たとえばpugiconfig.hppで次のように定義すれば指定できます。

pugixmlはヘッダーオンリーモードでも使用できます。これは、pugixml.hppをインクルードするすべての翻訳単位に、pugixmlのソースコード全体が含まれることを意味します。BoostやSTLのライブラリの多くはこの方法で動作しています。

この方法には利点も欠点もあります。ツールチェーンがリンク時最適化に対応していない場合や、それを無効にしている場合には、多くの単純な関数がインライン化されるため、ヘッダーモードでツリーの走査・変更性能が向上することがあります。リンク時最適化を使う場合の性能は、ヘッダーオンリーでないモードと同程度になるはずです。ただし、コンパイラーはpugixmlをインクルードする翻訳単位ごとにそのソースをコンパイルしなければならないため、コンパイル時間が大幅に増えることがあります。ヘッダーモードで使いたいもののXPathは不要な場合は、PUGIXML_NO_XPATHの定義でXPathを無効にし、コンパイル時間を短縮することを検討できます。

ヘッダーオンリーモードを有効にするには、PUGIXML_HEADER_ONLYを定義する必要があります。pugiconfig.hppに定義するか、コンパイラーのコマンドラインで指定できます。

PUGIXML_HEADER_ONLYが定義されていても、pugixml.cppをコンパイルして問題ありません。たとえばRelease構成だけでヘッダーオンリーモードを使いたい場合は、pugixml.cppをプロジェクトに含め（ほかの静的ライブラリ・実行ファイルの一部としてビルドする方法を参照）、次のようにpugiconfig.hppで条件付きでヘッダーオンリーモードを有効にできます。

pugixmlはいくつかの定義を使ってコンパイル処理を制御します。定義方法は2つあります。必要な定義をpugiconfig.hppに記述する（コメントアウトされた例がいくつかあります）か、コンパイラーのコマンドラインで指定します。一貫性が重要です。アプリケーション全体で、pugixml.hppをインクルードするすべてのソースファイル（pugixmlのソースも含む）の定義を一致させてください。pugiconfig.hppへ定義を追加すれば、この一致を保証できます。ただし、マクロ定義をプリプロセッサーの#ifや#ifdef指令で囲んでいて、その指令が一貫していない場合は除きます。pugiconfig.hppに初めから入っているのは常にコメントだけなので、新しい版へ更新するときにも、自分で変更した版をそのまま安全に残せます。

PUGIXML_WCHAR_MODEの定義は、UTF-8形式のインターフェース（メモリー内のテキストをUTF-8と仮定し、ほとんどの関数が文字型としてcharを使う）と、UTF-16/32形式のインターフェース（wchar_tのサイズに応じてメモリー内のテキストをUTF-16/32と仮定し、ほとんどの関数が文字型としてwchar_tを使う）を切り替えます。詳細はUnicodeインターフェースを参照してください。

PUGIXML_CHARCONV_FLOATを定義すると、浮動小数点数の書式設定に<stdio.h>の関数ではなく<charconv>を使います。これにはC++17とUTF-8インターフェースが必要です。この場合、変換はロケールを無視し、常に既定のCロケールを使う場合と同じように動作します。

PUGIXML_COMPACTの定義は、文書保存の内部表現を別のものへ切り替えます。ノードや属性などのマークアップが多い文書では、メモリー効率が大幅に向上しますが、解析やアクセスは少し遅くなります。詳細はコンパクトモードを参照してください。

PUGIXML_NO_XPATHの定義はXPathを無効にします。XPathのインターフェースと実装の両方がコンパイル対象から除かれます。このオプションは、XPathの機能が不要でコードサイズを節約したい場合のために用意されています。

PUGIXML_NO_STLの定義は、pugixmlでのSTLの使用を無効にします。このマクロを定義すると、STL型を扱う関数（iostream経由の読み込み・保存など）がなくなります。このオプションは、対象プラットフォームに標準準拠のSTL実装がない場合のために用意されています。

PUGIXML_NO_EXCEPTIONSの定義は、pugixmlでの例外の使用を無効にします。このオプションは、対象プラットフォームが例外処理機能を持たない場合のために用意されています。

PUGIXML_API、PUGIXML_CLASS、PUGIXML_FUNCTIONの定義により、pugixmlのクラスや非メンバー関数に独自の属性（declspecや呼び出し規約など）を指定できます。PUGIXML_CLASSやPUGIXML_FUNCTIONが定義されていない場合は、代わりにPUGIXML_APIの定義が使われます。たとえば、呼び出し規約を固定するには、PUGIXML_FUNCTIONを__fastcallなどと定義できます。別の例として、MSVCのDLLインポート・エクスポート属性があります（独立した共有ライブラリとしてビルドする方法を参照）。

PUGIXML_MEMORY_PAGE_SIZE、PUGIXML_MEMORY_OUTPUT_STACK、PUGIXML_MEMORY_XPATH_PAGE_SIZEは、特定の重要なサイズを調整し、アプリケーション固有の使用パターンに合わせてメモリー使用量を最適化するために使えます。詳細はメモリー消費の調整を参照してください。

PUGIXML_HAS_LONG_LONGの定義は、pugixmlでのlong long型のサポートを有効にします。この定義は、プラットフォームがlong longに対応していると分かっている場合（C++11に対応している場合や、既知のコンパイラーの比較的新しい版を使う場合など）には自動で有効になります。実際にはlong longに対応しているのにpugixmlがそれを認識しない場合は、手動で定義を有効にできます。

PUGIXML_HAS_STRING_VIEWの定義は、std::string_view引数を取る関数のオーバーロードを有効にします。C++17以降を対象にビルドすると、この定義は自動で有効になります。実際にはstd::string_viewに対応しているのにpugixmlがそれを認識しない場合は、手動で定義を有効にできます。