ui-extension-compiler-options.md 3.4 KB
title: "UiExtensionCompilerOptions" isDefaultIndex: false
generated: true
import MemberInfo from '@site/src/components/MemberInfo'; import GenerationInfo from '@site/src/components/GenerationInfo'; import MemberDescription from '@site/src/components/MemberDescription';
UiExtensionCompilerOptions
Options to configure how the Admin UI should be compiled.
interface UiExtensionCompilerOptions {
outputPath: string;
extensions: Extension[];
devMode?: boolean;
baseHref?: string;
watchPort?: number;
command?: 'yarn' | 'npm';
additionalProcessArguments?: UiExtensionCompilerProcessArgument[];
}
### outputPath
The directory into which the sources for the extended Admin UI will be copied.
### extensions
An array of objects which configure Angular modules and/or
translations with which to extend the Admin UI.
### devMode
Set to `true` in order to compile the Admin UI in development mode (using the Angular CLI
[ng serve](https://angular.io/cli/serve) command). When in dev mode, any changes to
UI extension files will be watched and trigger a rebuild of the Admin UI with live
reloading.
### baseHref
Allows the baseHref of the compiled Admin UI app to be set. This determines the prefix
of the app, for example with the default value of `'/admin/'`, the Admin UI app
will be configured to be served from `http:///admin/`.
Note: if you are using this in conjunction with the AdminUiPlugin then you should
also set the `route` option to match this value.
*Example*
```ts
AdminUiPlugin.init({
route: 'my-route',
port: 5001,
app: compileUiExtensions({
baseHref: '/my-route/',
outputPath: path.join(__dirname, './custom-admin-ui'),
extensions: [],
devMode: true,
}),
}),
```
### watchPort
In watch mode, allows the port of the dev server to be specified. Defaults to the Angular CLI default
of `4200`.
### command
Internally, the Angular CLI will be invoked as an npm script. By default, the compiler will use Yarn
to run the script if it is detected, otherwise it will use npm. This setting allows you to explicitly
set which command to use, rather than relying on the default behavior.
### additionalProcessArguments
UiExtensionCompilerProcessArgument[]`} default="undefined" since="1.5.0" />
Additional command-line arguments which will get passed to the [ng build](https://angular.io/cli/build)
command (or [ng serve](https://angular.io/cli/serve) if `devMode = true`).
*Example*
['--disable-host-check'] // to disable host check