mirror of
https://github.com/Alfresco/alfresco-content-app.git
synced 2026-09-09 18:02:54 +00:00
[ACS-12322] Update docs
This commit is contained in:
@@ -6,4 +6,4 @@ runs:
|
||||
steps:
|
||||
- name: Check content UP
|
||||
shell: bash
|
||||
run: pnpm run ci:check-env || exit 1
|
||||
run: pnpm ci:check-env || exit 1
|
||||
|
||||
@@ -38,7 +38,7 @@ runs:
|
||||
shell: bash
|
||||
run: |
|
||||
pnpm install --frozen-lockfile
|
||||
pnpm run build.release
|
||||
pnpm build.release
|
||||
|
||||
- name: Build and push multi-platform image
|
||||
uses: docker/build-push-action@v7
|
||||
|
||||
@@ -28,7 +28,7 @@ runs:
|
||||
shell: bash
|
||||
run: |
|
||||
pnpm install --frozen-lockfile
|
||||
pnpm run ci:build:many
|
||||
pnpm ci:build:many
|
||||
|
||||
- uses: actions/setup-node@v7
|
||||
name: setup GH registry
|
||||
|
||||
@@ -53,7 +53,7 @@ runs:
|
||||
|
||||
for attempt in $(seq 1 "${SUITE_ATTEMPTS:-1}"); do
|
||||
echo "Running playwright tests with options $OPTIONS on browser ${PLAYWRIGHT_BROWSER} (suite attempt $attempt/${SUITE_ATTEMPTS:-1})"
|
||||
if E2E_TARGET=$OPTIONS pnpm run ci:e2e; then
|
||||
if E2E_TARGET=$OPTIONS pnpm ci:e2e; then
|
||||
exit 0
|
||||
fi
|
||||
if [ "$attempt" -lt "${SUITE_ATTEMPTS:-1}" ]; then
|
||||
|
||||
@@ -45,15 +45,15 @@ jobs:
|
||||
fetch-depth: 2
|
||||
|
||||
- uses: ./.github/actions/before-install
|
||||
- run: npm ci
|
||||
- run: pnpm install --frozen-lockfile
|
||||
- name: upload npm logs
|
||||
uses: actions/upload-artifact@v7
|
||||
if: failure()
|
||||
with:
|
||||
name: npm-logs
|
||||
path: /home/runner/.npm/_logs/
|
||||
- run: npm run ci:build -- aca-playwright-shared
|
||||
- run: npm run build -- $BUILD_OPTS
|
||||
- run: pnpm ci:build -- aca-playwright-shared
|
||||
- run: pnpm build -- $BUILD_OPTS
|
||||
|
||||
- name: dist cache
|
||||
if: ${{ success() }}
|
||||
@@ -146,7 +146,7 @@ jobs:
|
||||
uses: ./.github/actions/before-install
|
||||
|
||||
- name: Install dependencies
|
||||
run: npm ci
|
||||
run: pnpm install --frozen-lockfile
|
||||
|
||||
- name: Restore dist cache
|
||||
uses: actions/cache/restore@v6
|
||||
@@ -160,15 +160,15 @@ jobs:
|
||||
|
||||
- name: Check Search Indexing
|
||||
continue-on-error: true
|
||||
run: npm run ci:check-search-indexing
|
||||
run: pnpm ci:check-search-indexing
|
||||
env:
|
||||
ADMIN_PASSWORD_SCRIPT: ${{ env.ADMIN_PASSWORD }}
|
||||
|
||||
- name: Before playwright
|
||||
run: npm run ci:playwright:install:all
|
||||
run: pnpm ci:playwright:install:all
|
||||
|
||||
- name: Install Playwright system dependencies
|
||||
run: npx playwright install-deps
|
||||
run: pnpm exec playwright install-deps
|
||||
|
||||
- name: Run e2e playwright
|
||||
uses: ./.github/actions/run-e2e-playwright
|
||||
|
||||
@@ -45,11 +45,11 @@ jobs:
|
||||
|
||||
- name: lint affected
|
||||
if: ${{ github.event_name == 'pull_request' }}
|
||||
run: pnpm run affected:lint -- --base=origin/develop
|
||||
run: pnpm affected:lint -- --base=origin/develop
|
||||
- name: lint all
|
||||
if: ${{ github.event_name != 'pull_request' }}
|
||||
run: pnpm run ci:lint
|
||||
- run: pnpm run stylelint
|
||||
run: pnpm ci:lint
|
||||
- run: pnpm stylelint
|
||||
|
||||
detect-e2e-only-changes:
|
||||
name: 'Validate / Detect E2E Only Changes'
|
||||
@@ -96,8 +96,8 @@ jobs:
|
||||
with:
|
||||
name: npm-logs
|
||||
path: /home/runner/.npm/_logs/
|
||||
- run: pnpm run ci:build -- aca-playwright-shared
|
||||
- run: pnpm run build -- $BUILD_OPTS
|
||||
- run: pnpm ci:build -- aca-playwright-shared
|
||||
- run: pnpm build -- $BUILD_OPTS
|
||||
|
||||
- name: dist cache
|
||||
if: ${{ success() }}
|
||||
@@ -127,11 +127,11 @@ jobs:
|
||||
|
||||
- name: Test
|
||||
if: ${{ github.event_name == 'pull_request' }}
|
||||
run: pnpm run affected:test -- --browsers=ChromeHeadless --watch=false $TEST_OPTS --base=origin/develop
|
||||
run: pnpm affected:test -- --browsers=ChromeHeadless --watch=false $TEST_OPTS --base=origin/develop
|
||||
|
||||
- name: Test all
|
||||
if: ${{ github.event_name != 'pull_request' }}
|
||||
run: pnpm run ci:test -- $TEST_OPTS
|
||||
run: pnpm ci:test -- $TEST_OPTS
|
||||
|
||||
e2es-playwright:
|
||||
if: ${{ !contains(github.event.pull_request.labels.*.name, 'ci:skip-e2e') }}
|
||||
@@ -233,12 +233,12 @@ jobs:
|
||||
|
||||
- name: Check Search Indexing
|
||||
continue-on-error: true
|
||||
run: pnpm run ci:check-search-indexing
|
||||
run: pnpm ci:check-search-indexing
|
||||
env:
|
||||
ADMIN_PASSWORD_SCRIPT: ${{ env.ADMIN_PASSWORD }}
|
||||
|
||||
- name: Before playwright
|
||||
run: pnpm run ci:playwright:install
|
||||
run: pnpm ci:playwright:install
|
||||
|
||||
- name: Run e2e playwright
|
||||
uses: ./.github/actions/run-e2e-playwright
|
||||
|
||||
@@ -62,8 +62,8 @@ jobs:
|
||||
|
||||
- uses: ./.github/actions/setup
|
||||
- run: pnpm install --frozen-lockfile
|
||||
- run: pnpm run affected:lint -- --base=origin/develop
|
||||
- run: pnpm run stylelint
|
||||
- run: pnpm affected:lint -- --base=origin/develop
|
||||
- run: pnpm stylelint
|
||||
|
||||
unit-tests:
|
||||
if: github.event_name == 'workflow_dispatch'
|
||||
@@ -84,7 +84,7 @@ jobs:
|
||||
|
||||
- uses: ./.github/actions/before-install
|
||||
- run: pnpm install --frozen-lockfile
|
||||
- run: pnpm run affected:test -- --browsers=ChromeHeadless --watch=false $TEST_OPTS --base=origin/develop
|
||||
- run: pnpm affected:test -- --browsers=ChromeHeadless --watch=false $TEST_OPTS --base=origin/develop
|
||||
|
||||
publish-docker-registry:
|
||||
if: ${{ always() }}
|
||||
|
||||
@@ -47,8 +47,8 @@ jobs:
|
||||
cache: 'pnpm'
|
||||
- uses: ./.github/actions/before-install
|
||||
- run: pnpm install --frozen-lockfile
|
||||
- run: pnpm run ci:build -- aca-playwright-shared
|
||||
- run: pnpm run build -- $BUILD_OPTS
|
||||
- run: pnpm ci:build -- aca-playwright-shared
|
||||
- run: pnpm build -- $BUILD_OPTS
|
||||
|
||||
- name: dist cache
|
||||
if: ${{ success() }}
|
||||
@@ -134,7 +134,7 @@ jobs:
|
||||
uses: ./.github/actions/before-e2e
|
||||
|
||||
- name: Before playwright
|
||||
run: pnpm run ci:playwright:install
|
||||
run: pnpm ci:playwright:install
|
||||
|
||||
- uses: ./.github/actions/run-e2e-playwright
|
||||
with:
|
||||
|
||||
@@ -7,7 +7,8 @@ Please refer to the public [documentation](https://alfresco-content-app.netlify.
|
||||
| Name | Version |
|
||||
|---------|---------|
|
||||
| Node.js | 24.x |
|
||||
| Npm | 11.x |
|
||||
| Npm | 11.x |
|
||||
| Pnpm | 11.x |
|
||||
|
||||
## Compatibility
|
||||
|
||||
@@ -48,8 +49,8 @@ Where `<URL>` is the address of the ACS.
|
||||
Run the following commands:
|
||||
|
||||
```sh
|
||||
npm install
|
||||
npm start
|
||||
pnpm install
|
||||
pnpm start
|
||||
```
|
||||
|
||||
## Unit Tests
|
||||
|
||||
@@ -119,14 +119,14 @@ Be sure to mention that developers should have a build rule to copy your plugin
|
||||
Before you publish you should always rebuild the library:
|
||||
|
||||
```sh
|
||||
npm run build:my-extension
|
||||
pnpm build:my-extension
|
||||
```
|
||||
|
||||
Go to the output folder and run the publish command.
|
||||
|
||||
```sh
|
||||
cd dist/my-extension
|
||||
npm publish
|
||||
pnpm publish
|
||||
```
|
||||
|
||||
Note, you are required to have a valid [NPM](https://www.npmjs.com/) account.
|
||||
@@ -138,7 +138,7 @@ See more details in the [Publishing your library](https://github.com/angular/ang
|
||||
Assuming you have published your extension library to NPM, you can install it using the standard command:
|
||||
|
||||
```sh
|
||||
npm install my-extension
|
||||
pnpm add my-extension
|
||||
```
|
||||
|
||||
This installs the library and all its dependencies.
|
||||
@@ -199,7 +199,7 @@ Finally, update the `src/assets/app.extensions.json` file and add a reference to
|
||||
Run the application and ensure you have an extra navigation sidebar entry:
|
||||
|
||||
```sh
|
||||
npm start
|
||||
pnpm start
|
||||
```
|
||||
|
||||
Click the `My Extension` link and in the main content area you will see the extension component coming from your library.
|
||||
|
||||
@@ -3,7 +3,7 @@
|
||||
Running local build with Docker
|
||||
|
||||
```shell
|
||||
npm run build
|
||||
pnpm run build
|
||||
```
|
||||
|
||||
The application is already preconfigured to run alongside backend containers within the Docker Compose.
|
||||
|
||||
@@ -5,7 +5,7 @@ If you are working with ADF source code and want to use the modified version wit
|
||||
Clone the `alfresco-ng2-components` and `alfresco-content-app` repositories in the same folder, and run the following command:
|
||||
|
||||
```sh
|
||||
npm start -- --configuration=adf
|
||||
pnpm start --configuration=adf
|
||||
```
|
||||
|
||||
Changing the ADF code results in the recompilation and hot-reloading of the ACA application.
|
||||
|
||||
@@ -68,8 +68,8 @@ npm install -g @nrwl/cli
|
||||
In the VS Code Terminal (powershell), run the following:
|
||||
|
||||
```sh
|
||||
npm install
|
||||
npm start
|
||||
pnpm install
|
||||
pnpm start
|
||||
```
|
||||
|
||||
The application should open at `http://localhost:4200` by default.
|
||||
|
||||
@@ -17,10 +17,10 @@ First create a folder where you would like to place the extensions. i.e. `/exten
|
||||
|
||||
Then run the `@nx/angular` library generator using the following command as a template:
|
||||
```console
|
||||
npx nx generate @nx/angular:library --name=@myorg/my-extension --buildable=true --directory=extensions/myextension --publishable=true --importPath=@myorg/my-extension --projectNameAndRootFormat=as-provided --no-interactive
|
||||
pnpm exec nx generate @nx/angular:library --name=@myorg/my-extension --buildable=true --directory=extensions/myextension --publishable=true --importPath=@myorg/my-extension --projectNameAndRootFormat=as-provided --no-interactive
|
||||
```
|
||||
|
||||
where `name` is the name of the library, `directory` is a directory where the library is placed and `importPath` is the library name used for the import, like `@myorg/my-awesome-lib`. This must be a valid npm package name.
|
||||
where `name` is the name of the library, `directory` is a directory where the library is placed and `importPath` is the library name used for the import, like `@myorg/my-awesome-lib`. This must be a valid pnpm package name.
|
||||
|
||||
See the official [Nx Angular library](https://nx.dev/nx-api/angular/generators/library) documentation for more details.
|
||||
|
||||
@@ -38,7 +38,7 @@ Next to validate the changed verify the following:
|
||||
}
|
||||
```
|
||||
|
||||
- Test if npm i is working:
|
||||
- Test if pnpm install is working:
|
||||
|
||||
# Developing the basics of the ACA extension
|
||||
|
||||
@@ -161,13 +161,13 @@ Last but not least, edit the package.json file to allow the build of the extensi
|
||||
|
||||
Once done, create the build of the extension running the following command.
|
||||
|
||||
npm install my-extension
|
||||
pnpm add my-extension
|
||||
|
||||
# Running ACA with the extension included
|
||||
|
||||
Now that everything is properly developed, it’s time to launch ADW and see the result. To launch ADW, run the following command from a terminal.
|
||||
|
||||
npm start
|
||||
pnpm start
|
||||
|
||||
What you should see is a new item in left menu of the landing page for ACA, implementing the route to a new page with the following content. Below the screenshot describing what it should look like.
|
||||
|
||||
|
||||
@@ -46,12 +46,12 @@ After Replace:
|
||||
```
|
||||
2. Install your dependencies
|
||||
```sh
|
||||
npm i
|
||||
pnpm i
|
||||
```
|
||||
|
||||
3. Run the application
|
||||
```sh
|
||||
npm start
|
||||
pnpm start
|
||||
```
|
||||
|
||||
**Note:** The compiler gives errors and complains about adf libraries with ‘has no exported member’ errors. You can find many errors with different adf libraries.
|
||||
@@ -98,15 +98,15 @@ Error 2:
|
||||
You need to update the datetimepicker dependencies.
|
||||
|
||||
```sh
|
||||
npm install --save @mat-datetimepicker/core@9
|
||||
npm install --save @mat-datetimepicker/moment@9
|
||||
pnpm add @mat-datetimepicker/core@9
|
||||
pnpm add @mat-datetimepicker/moment@9
|
||||
```
|
||||
|
||||
Make sure you have installed dev dependency for the below dependencies
|
||||
|
||||
```sh
|
||||
npm install --save-dev inquirer@^8.0.0
|
||||
npm install --save-dev winston@^3.8.2
|
||||
pnpm add -D inquirer@^8.0.0
|
||||
pnpm add -D winston@^3.8.2
|
||||
```
|
||||
|
||||
BREAKING CHANGE: webpack < 5 used to include polyfills for node.js core modules by default.
|
||||
|
||||
Reference in New Issue
Block a user