mirror of
https://github.com/Alfresco/alfresco-ng2-components.git
synced 2025-07-31 17:38:48 +00:00
48 lines
2.2 KiB
Markdown
48 lines
2.2 KiB
Markdown
# Prerequisites for building and running apps with the Alfresco Application Development Framework
|
|
|
|
The [Angular 2](https://angular.io/) based application development framework requires the following:
|
|
|
|
- An Alfresco Platform Repository (version [5.2.a-EA](https://wiki.alfresco.com/wiki/Community_file_list_201606-EA) or newer) to talk to, which has [CORS](https://en.wikipedia.org/wiki/Cross-origin_resource_sharing) enabled.
|
|
- [Download and install Activiti](https://www.alfresco.com/products/bpm/alfresco-activiti/trial)
|
|
- [Node.js](https://nodejs.org/en/) JavaScript runtime.
|
|
- [npm](https://www.npmjs.com/) package manager for JavaScript.
|
|
|
|
**Verify that you are running at least node `v5.x.x` and npm `3.x.x`**
|
|
by running `node -v` and `npm -v` in a terminal/console window.
|
|
Older versions produce errors.
|
|
|
|
## Installing Node.js
|
|
|
|
If you don't have Node.js installed then access this [page](https://nodejs.org/en/download/) and use the appropriate installer for your OS.
|
|
|
|
Make sure the Node.js version is > 5:
|
|
|
|
```
|
|
$ node -v
|
|
v5.12.0
|
|
```
|
|
|
|
## Configure Nginx
|
|
|
|
To correctly configure Nginx use the following file [nginx.conf](/nginx.conf).
|
|
This will put Activiti, Alfresco and the app dev framework under the same domain.
|
|
|
|
* ECM : http://localhost:8888/alfresco/
|
|
* BPM : http://localhost:8888/activiti/
|
|
|
|
To make everything work, you have to change the address of the ECM and BPM. In the demo app you can do that clicking on the top left menu and changing the bottom left options: ECM host and BPM host.
|
|
|
|
This configuration assumes few things:
|
|
|
|
* Port mapping:
|
|
* Nginx entry point: 8888
|
|
* Demo Shell: 3000
|
|
* Alfresco: 8080
|
|
* Activiti: 9999
|
|
|
|
All those values can be modified at their respective `location` directive on the [nginx.conf](/nginx.conf) file.
|
|
|
|
It also need to be compiled with the [Headers More](https://www.nginx.com/resources/wiki/modules/headers_more/) module , which add more control over sending headers to the backend.
|
|
|
|
If you want to know more on how to install and configure NginX to work with the Application Development Framework can be found [here](https://community.alfresco.com/community/application-development-framework/blog/2016/09/28/adf-development-set-up-with-nginx-proxy)
|