An extension for the Yeoman generator to create minimal Alfresco ADF applications.
See the following page for an introduction to the Alfresco Application Development Framework.
Before you start using this development framework and the generator, make sure you have installed all required software and done all the necessary configuration, see this page.
Install the LTS (Long-Term Support) version of the Node.js: https://nodejs.org/en/download/
You can use the official macOS installer from the https://nodejs.org/en/download/ page, it includes the NPM as well.
Use this article to get details on how to install Node.js and NPM on Ubuntu: https://linuxize.com/post/how-to-install-node-js-on-ubuntu-20-04/
It is important to install the developer tools:
sudo apt install build-essential
Use this article to get details on how to install Node.js and NPM on CentOS: https://linuxize.com/post/how-to-install-node-js-on-centos-7/
It is important to install the developer tools:
sudo yum install gcc-c++ make
First, install the Yeoman tool:
npm install -g yo
Use the following command to install the Alfresco App Generator for the Yeoman:
npm install -g generator-alfresco-adf-app
To install a specific version, use @ followed by the version.
npm install -g generator-alfresco-adf-app@WHERSION_YOU_WANT
Some tags in the project may not be available in npm. See available versions for npm
First, move in the folder where you want create your project.
yo alfresco-adf-app
You will need to run the following scripts in the generated folder:
npm install
npm start
Commands above install all project dependencies, start the project and watch for changes.
Alternatively you can use generator with install switch to trigger automatic installation of dependencies via npm install script:
yo alfresco-adf-app --install
For the projects running with Activiti 7 you need to update the app.config.json with the list of the apps to use.
For example:
{
"alfresco-deployed-apps" : [{"name": "simple-app"}]
}
For more information about the app list component refer to the documentation
You can use the generator in the unattended mode by providing all necessary options from the command line:
yo ng2-alfresco-app -n app2 -b adf-cli-aps-template -i
Options:
Name | Alias | Type | Description |
---|---|---|---|
--name=<value> | -n <value> | string | Application name |
--blueprint=<value> | -b <value> | string | Blueprint name |
--install | -i | boolean | Install dependencies upon generation |
Default blueprint names:
- adf-cli-acs-aps-template
- adf-cli-acs-template
- adf-cli-aps-template
npm update -g generator-alfresco-adf-app
Show current version generator-alfresco-adf-app installed
npm ls -g generator-alfresco-adf-app
- Fork it!
- Create your feature branch:
git checkout -b my-new-feature
- Make some changes
- Add the changes to the index:
git add .
- Commit your changes:
git commit -m 'Add some feature'
- Push to the branch:
git push origin my-new-feature
- Submit a pull request
To Contribute to the existing code base, add test cases to cover the new behaviour, and make sure all the existing tests are still green.
To test the generator:
npm test
To scaffold app from local changes:
yo <cloned project path>
Example
yo ../generator-alfresco-adf-app # this generates from the local changes
In order to add a new blueprint just put the project template to the app/templates
folder.
Requirements for new projects:
- must contain
package.json
file - the
package.json
file must contain at leastname
andversion
attributes
# OS X / Linux
DEBUG=yeoman:generator yo alfresco-adf-app
# Windows
set DEBUG=yeoman:generator & yo alfresco-adf-app
More on debugging generators.
For detailed changelog, see Releases.