遺物の発見

プロジェクトで外部アーティファクトを使用するには、build.gradleのGradleスクリプトでそれらの依存関係を設定する必要があります。

アーティファクトを依存関係として指定する前に、まずその属性を見つける必要があります。 アーティファクトには次の属性があります。

• グループID: 作成組織
• アーティファクトID: 名前/識別子
• バージョン: リリース番号

ここでは、アーティファクト属性を見つけて依存関係を指定する方法を学習します。

コアアーティファクト属性の発見

各Liferayアーティファクトは、アーティファクトのOSGiバンドルメタデータ属性を含むMETA-INF/MANIFEST.MFファイルが含まれるJARファイルです。 たとえば、次の2つのOSGiヘッダーは、アーティファクトIDとバージョンを指定します。

Bundle-SymbolicName: [アーティファクトID]
Bundle-Version: [バージョン]

重要

Liferay DXPの修正パックに含まれるアーティファクトは、Liferay DXPのインストール時に作成されるアーティファクトを上書きします。 フィックスパック内の バイナリ フォルダーには、サブフォルダーにアーティファクトが含まれています。 プロジェクトで修正パックに含まれる成果物が必要な場合は、依存関係を宣言する際に、その修正パックのバージョンを指定してください。

Liferayのコアアーティファクトを見つける場所は次のとおりです。

ファイル	グループID	アーティファクトID	バージョン	起源
portal-kernel.jar	com.liferay.portal	com.liferay.portal.kernel	(JARファイルの MANIFEST.MFを参照してください)	修正パックZIP、Liferayインストール、またはLiferay依存関係ZIP
portal-impl.jar	com.liferay.portal	com.liferay.portal.impl	(JARファイルの MANIFEST.MFを参照してください)	修正パックZIPまたはLiferay .war
util-bridges.jar	com.liferay.portal	com.liferay.util.bridges	(JARファイルの MANIFEST.MFを参照してください)	修正パックZIPまたはLiferay .war
util-java.jar	com.liferay.portal	com.liferay.util.java	(JARファイルの MANIFEST.MFを参照してください)	修正パックZIPまたはLiferay .war
util-slf4j.jar	com.liferay.portal	com.liferay.util.slf4j	(JARファイルの MANIFEST.MFを参照してください)	修正パックZIPまたはLiferay .war
util-taglibs.jar	com.liferay.portal	com.liferay.util.taglib	(JARファイルの MANIFEST.MFを参照してください)	修正パックZIPまたはLiferay .war
com.liferay.* JARファイル	com.liferay	(JARファイルの MANIFEST.MFを参照してください)	(JARファイルの MANIFEST.MFを参照してください)	修正パックZIP、Liferayインストール、Liferay依存関係ZIP、またはOSGi ZIP

次に、Liferayアプリと独立したモジュールアーティファクトの属性を見つける方法を学びます。

Liferayアプリと独立したアーティファクトの検索

コア外のモジュールの場合でも、必要なモジュールへの依存関係を指定する必要があります。 必要な依存関係を見つけるには、次の3つの方法があります。

リソース	アーティファクトタイプ
アプリマネージャー	デプロイされたモジュール
参考資料	Liferayモジュール（リリースごと）
メイブンセントラル	すべてのアーティファクトのタイプ：Liferayとサードパーティ、モジュールと非モジュール

重要

com.liferay は、Liferay のすべてのアプリと独立したモジュールのグループ ID です。

アプリケーションマネージャは、デプロイされたモジュールに関する最良の情報を提供します。

アプリマネージャー

アプリケーションマネージャー には、Liferay インスタンスにデプロイされているものが表示されます。

1. Liferay では、 グローバルメニュー () をクリックし、 コントロールパネル に移動します。

2. システム カテゴリで、 アプリ マネージャー を選択します。

3. モジュールの表示名、シンボル名、または関連キーワードで検索してください。 アプリ一覧からモジュールを閲覧することもできます。 閲覧時でも検索時でも、アプリマネージャーには各モジュールのアーティファクトIDとバージョン番号が表示されます。

アプリケーションマネージャは、独立モジュールを独立モジュールカテゴリに集約します。

独立モジュールのグループIDがわからない場合は、 Felix Gogo Shell を使用して検索してください。

1. コントロール パネルのシステム カテゴリで、 Gogo Shell を選択します。 Gogo Shellのコマンドプロンプトにコマンドを入力してください。

2. モジュールの表示名（例： Apache Aries CDI）またはキーワードで検索します。 結果には、モジュールの番号を記載してください。 次のステップで使用できます。 以下の例は、Liferay Announcements API モジュール番号 47 を示しています。

   

3. モジュール番号とともに ヘッダー コマンドを使用して、そのマニフェスト ヘッダーを表示します。 Bundle-Vendor または Implementation-Vendor の値に注目してください。 後の手順で、それをアーティファクトグループと照合します。

   

4. Maven CentralまたはMVNRepositoryで、アーティファクトIDでモジュールを検索します。

5. 手順3のBundle-VendorまたはImplementation-Vendorの名前を、アーティファクトを提供するグループと照合して、グループIDを決定します。

Liferay参照ドキュメントには、Liferayアプリのアーティファクト属性も記載されています。

参考資料

LiferayのアプリJavadocには、各アプリモジュールのアーティファクトID、バージョン番号、表示名が一覧表示されます。 これは、LiferayインスタンスにまだデプロイされていないLiferayアプリモジュールを検索するのに最適な場所です。

注記

Core Liferay アーティファクトのアーティファクト情報を見つけるには、前のセクション Core Liferay アーティファクト属性の検索 を参照してください。

JavadocでLiferayアプリモジュールの属性を見つけるには、次の手順に従います。

1. アプリモジュールクラスのJavadocを参照してください。 クラスのJavadocへのリンクがない場合は、LiferayエディションのアプリJavadocを参照して探してください。

   Liferay DXP: https://docs.liferay.com/dxp/apps

   Liferayポータル: https://docs.liferay.com/ce/apps

2. クラスのパッケージ名をコピーします。

3. 概要 ページに移動します。

4. 概要 ページで、手順 2 でコピーしたパッケージ名を検索します。

パッケージ名の上の見出しには、モジュールのアーティファクトID、バージョン番号、表示名が表示されます。 すべてのアプリモジュールのグループIDはcom.liferayであることを思い出してください。

注記

モジュールのバージョン番号は、現在どのタグライブラリのリファレンスドキュメントにも含まれていません。

次に、MVNRepositoryおよびMaven Centralでアーティファクトを検索する方法を学習します。

メイブンセントラル

タイプや原点に関係なく、ほとんどのアーティファクトはMVNRepositoryとMavenCentralにあります。 これらのサイトは、クラスパッケージに基づいてアーティファクトを見つけるのに役立ちます。 アーティファクトのパッケージ名の先頭にアーティファクトのIDを含めるのが一般的です。 たとえば、クラスorg.osgi.service.component.annotations.Componentに依存している場合は、Mavenサイトの1つでパッケージ名org.osgi.service.component.annotationsを検索します。

注記

必要なLiferayアーティファクトのバージョンを特定するには、上記の手順に従ってください。

次は？

アーティファクトの属性がわかったので、アーティファクトへの依存関係を構成できます。 詳細については、 依存関係の指定 を参照してください。

関連トピック

• パッケージのインポート
• パッケージのエクスポート
• サードパーティライブラリパッケージの依存関係の解決
• WARファイルのデプロイ（WABジェネレーター）