1. MVVMアーキテクチャを使用したOracle JETアプリケーションの開発
  2. oraclejetconfig.jsonファイルのプロパティ

D oraclejetconfig.jsonファイルのプロパティ

oraclejetconfig.jsonファイルは、Oracle JETプロジェクトの動作を決定するために構成できる様々なプロパティをサポートしています。

ノート:

Propertyが<prop>.<subprop>の場合、<subprop>は<prop>のサブプロパティであることを示します。たとえば、paths.componentsは"paths": { "components": "value" }を意味します。

表D-1 oraclejetconfig.jsonファイルのプロパティ

プロパティ 値タイプ 有効な値 デフォルト ノート
architecture 文字列 mvvmまたはvdom mvvm アプリケーション・アーキテクチャのタイプ。
components オブジェクト コンポーネント名/バージョン値のペア このプロパティのデフォルト値は存在しません。

ojet restore時にコンポーネント交換からリストアされるコンポーネントのコンポーネント名/バージョン値のペア。package.jsonと同様の形式です。たとえば:

"components": { "oj-doceg-double-picker": "^2.0.0" }

bundleName 文字列 拡張子が.JSの単純なファイル名 bundle.js 最適化されたアプリケーションに使用されるデフォルト名のオーバーライドを許可します。
bundler 文字列 webpack | <any> このプロパティのデフォルト値は存在しません。

リリース11.0.0で、JETはWebpackのバンドルのみのサポートを導入しました。webpackがbundlerプロパティの値として指定されている場合、before_webpackフックを使用してアプリケーションがバンドルされていました。それ以外の場合は、before_optimizeフックがRequireJSベースのアプリケーション・バンドルを管理していました。Webpackベースのバンドルは、アプリケーション・バンドルにのみ適用されていました。カスタム・コンポーネントの最適化では引き続きRequireJSベースのバンドルが使用され、before_component_optimizeフックで構成できました。

リリース12.0.0で、JETはエンドツーエンドのWebpackサポートを導入しました。ojet createコマンドに--webpack引数を指定すると、Oracle JETは、Webpackの使用を構成するojet.config.jsファイルを作成します。oraclejetconfig.jsonファイルにbundlerプロパティは構成されません。

defaultBrowser 文字列 ブラウザ名 chrome 宛先がbrowserの場合、ハイブリッド・モバイル・アプリケーションを--targetとして提供する際にApache Cordovaに送信されます。
defaultTheme 文字列 redwood、redwood-notag、stable redwood

アプリケーションでデフォルトとして使用するテーマの名前。

dependencies オブジェクト コンポーネント名/オブジェクトまたはバージョン番号のペア このプロパティのデフォルト値は存在しません。

特定の事前に縮小されたコンポーネントをojet build --releaseバンドル・プロセスから除外するかどうかを確認するために使用される、潜在的なコンポーネントまたはパックの依存性の名前。たとえば:

"dependencies": { "oj-pack-comp": { "version": "2.0.0"} }

または

"oj-comp": "2.0.0"

exchange-url 文字列 URL このプロパティのデフォルト値は存在しません。

コンポーネントを公開するためのコンポーネント交換インスタンス。たとえば:

https://exchange.url.com/api/0.2.0

ノート:

この設定は、ojet configure --exchange-url=<addr> --globalで定義されたグローバル値から継承することもできます(存在しない場合)。この値は、一元的に格納されます(たとえば.ojet/exchange-url.jsonなど)
generatorVersion 文字列 Oracle JET CLIバージョン このプロパティのデフォルト値は存在しません。 非推奨。プロジェクトの作成に最初に使用されたJETのバージョンに関する履歴情報です。CLIでは使用されません。
installer 文字列 yarnまたはnpm npm 指定した場合、npm installタイプのコマンドで、デフォルトのnpmのかわりに実行する代替インストーラです。
localComponentsSupport ブール true/false このプロパティのデフォルト値は存在しません。 コンポーネント交換バックエンドがlocal components拡張をサポートするかどうかを示します。値は、CLIによってoraclejetconfig.jsonに記録されます。ユーザーがローカル・コンポーネント・サポートからオプト・アウトする場合は、この値を意図的にfalseに設定できます。
paths.components 文字列 パス jet-composites

ローカルで作成されたコンポーネントが、スキャフォールド済プロジェクト・タイプに依存するルートに対して相対的に格納されるパス:

  1. --vdomまたは--template=basic-vdomテンプレートで作成されたプロジェクト。ルートはsrc/になります。
  2. --typescriptで作成されたプロジェクト。ルートはsrc/ts/になります。
  3. デフォルトのプロジェクト。ルートはsrc/jsになります。

ノート:

vdom basicテンプレートまたは--vdomオプションで作成されたプロジェクトでは、この値はデフォルトのjet-compositesではなく、単にcomponentsに事前設定されます。
paths.exchangeComponents 文字列 パス exchange_components 交換から追加されたコンポーネントが新しい仮想DOMアプリケーション用に格納されるフォルダ。非仮想DOMアプリケーション(MVVM)では、これが設定されていない場合、古いjet_componentsが使用されます。このパスは、src/フォルダのピアとしてプロジェクトのルートに作成される単純なフォルダ名である必要があります。
paths.source.common 文字列 パス src プロジェクト・ルートに相対的な単純なフォルダ名。フォルダ階層はここでは使用できません。paths.componentsなどのその他の設定は、この場所に対して相対的になります。
paths.source.hybrid 文字列 パス src-hybrid プロジェクト・ルートに相対的な単純なフォルダ名。フォルダ階層はここでは使用できません。
paths.source.javascript 文字列 パス js 定義済のsrcフォルダに相対的な単純なフォルダ名。フォルダ階層はここでは使用できません。paths.componentsなどのその他の設定は、関連するプロジェクト・タイプのこの場所に対して相対的になることがあります。
paths.source.styles 文字列 パス css 定義済のsrcフォルダに相対的な単純なフォルダ名。フォルダ階層はここでは使用できません。
paths.source.themes 文字列 パス themes 定義済のsrcフォルダに相対的な単純なフォルダ名。フォルダ階層はここでは使用できません。
paths.source.tsconfig 文字列 パス   このサブプロパティを指定すると、アプリケーション・ルートのデフォルトの場所からtsconfig.jsonファイルの再配置が可能になります。定義済のsrcフォルダに相対的な単純なフォルダ名。フォルダ階層はここでは使用できません。
paths.source.typescript 文字列 パス ts 定義済のsrcフォルダに相対的な単純なフォルダ名。フォルダ階層はここでは使用できません。paths.componentsなどのその他の設定は、関連するプロジェクト・タイプのこの場所に対して相対的になることがあります。
paths.source.web 文字列 パス src-web 定義済のsrcフォルダに相対的な単純なフォルダ名。フォルダ階層はここでは使用できません。
paths.staging.hybrid 文字列 パス hybrid ハイブリッド・ビルド製品が生成されるパス。
paths.staging.themes 文字列 パス staged-themes テーマがステージングされるパス。
paths.staging.web 文字列 パス web Webビルド製品が生成されるパス。
sassVer 文字列 semverスタイルのバージョン番号 5.0.0 sassが追加された場合にインストールされるnode-sass npmパッケージのバージョン。
stripList 文字列の配列 パス文字列 このプロパティのデフォルト値は存在しません。 ojet stripの実行時に取り除く.gitignoreスタイルのパスのリスト。これにより、.gitignoreファイルのリストが省略されます。
unversioned ブール true/false false

trueの場合、ojet buildまたはojet serveを実行すると、Oracle JETではコンポーネント・バージョン番号なしのディレクトリ・パスにコンポーネントが生成されます。たとえば:

appRootDir/web/ts/jet-composites/my-cca-component-pack/my-widget-1

unversionedプロパティを指定しない場合、または"unversioned": false (デフォルト)を指定した場合、出力パスは次のようになります:

appRootDir/web/ts/jet-composites/1.0.0/my-cca-component-pack/my-widget-1

oraclejetconfig.jsonファイルのunversionedエントリは、Oracle JETコマンドライン引数(--omit-component-version)よりも優先されます。つまり、oraclejetconfig.jsonファイルに"unversioned": false (ディレクトリ・パスにコンポーネント・バージョン番号を含める)が含まれ、次のコマンドを使用してOracle JETアプリケーションを構築した場合、Oracle JETでは、生成されたディレクトリ・パスにコンポーネント・バージョンが含まれます:

ojet build --omit-component-version
watchInterval 文字列 ミリ秒数 1000 このプロパティの値を構成して、ライブ・リロード機能でOracle JETプロジェクトの更新をポーリングする間隔を構成します。デフォルト値は1000ミリ秒です。