grails create-app myapp --profile=angular
Grails Angular Profile
A profile for creating applications using Angular
Version: 1.1.1.BUILD-SNAPSHOT
Table of Contents
1 Introduction
Grails Profiles encapsulate project commands, templates, and plugins. To create an application using the angular profile you can use the next command:
You can also choose this project when generating your project from the Grails Application Forge, either from the web app or via the API:
curl -O start.grails.org/myapp.zip -d profile=angular
Grails Application Forge is a great way to discover the different provided features in the profile.
2 Usage
The previous command creates a Gradle multi-project build where the server
module contains the Grails application, and the client module contains the Angular 2 application.
-
To start the Grails application separately, execute
./gradlew server:bootRun -
To start the client side application separately, execute
./gradlew client:bootRun -
To start both the client and server applications simultaneously, execute
./gradlew bootRun --parallel
No need to install Node, though we would recommend doing so if you’ll be working with the front-end directly often!
Although the profile creates a multi-project build, it is possible to combine both client and server projects into a single build. Read the Guide Combining the Angular Profile Projects to learn how.
3 Upgrade
You can explore the differences between Grails versions, to ease the upgrade of your Grails application created with the angular profile.
4 Tests
Run the front-end unit tests and grails unit tests simultaneously with ./gradlew test
Run the front-end e2e and grails integration tests simultaneously with ./gradlew integrationTest
5 Profile Name
This profile was orginally named angular2. In order to be consistent with the Angular team’s guidelines on naming conventions it was renamed to angular Read about the angular profiles name changes.
|
6 Guides, Quickcast and Blog Posts
To learn more about the Angular profiles, check the following Grails Guides & Quickcasts:
The following blog posts would be useful too:
7 Profile Info
You can always get information about the provided command and available features executing
grails profile-info angular
You will see an output similar to:
grails profile-info angular
Profile: angular
--------------------
A profile for creating Grails applications with Angular 2
Provided Commands:
--------------------
| Error Error occurred loading commands: grails.dev.commands.ApplicationContextCommandRegistry (Use --stacktrace to see the full trace)
| Error Error occurred loading commands: grails.dev.commands.ApplicationContextCommandRegistry (Use --stacktrace to see the full trace)
| Error Error occurred loading commands: grails.dev.commands.ApplicationContextCommandRegistry (Use --stacktrace to see the full trace)
* help - Prints help information for a specific command
* open - Opens a file in the project
* gradle - Allows running of Gradle tasks
* create-controller - Creates a controller
* create-domain-resource - Creates a domain class that represents a resource
* create-functional-test - Creates an functional test
* create-integration-test - Creates an integration test
* create-interceptor - Creates an interceptor
* create-restful-controller - Creates a REST controller
* clean - Cleans a Grails application's compiled sources
* compile - Compiles a Grails application
* create-command - Creates an Application Command
* create-domain-class - Creates a Domain Class
* create-service - Creates a Service
* create-unit-test - Creates a unit test
* install - Installs a Grails application or plugin into the local Maven cache
* assemble - Creates a JAR or WAR archive for production deployment
* bug-report - Creates a zip file that can be attached to issue reports for the current project
* console - Runs the Grails interactive console
* create-script - Creates a Grails script
* dependency-report - Prints out the Grails application's dependencies
* list-plugins - Lists available plugins from the Plugin Repository
* plugin-info - Prints information about the given plugin
* run-app - Runs a Grails application
* run-command - Executes Grails commands
* run-script - Executes Groovy scripts in a Grails context
* shell - Runs the Grails interactive shell
* stats - Prints statistics about the project
* stop-app - Stops the running Grails application
* test-app - Runs the applications tests
* generate-all - Generates a controller that performs REST operations
* generate-controller - Generates a controller that performs REST operations
* generate-functional-test - Generates a functional test for a controller that performs REST operations
* generate-unit-test - Generates a unit test for a controller that performs REST operations
* generate-views - Generates a controller that performs REST operations
Provided Features:
--------------------
* security - Adds Spring Security REST to the project
* asset-pipeline - Adds Asset Pipeline to a Grails project
* events - Adds support for the Grails EventBus abstraction
* gsp - Adds support for GSP to the project
* hibernate4 - Adds GORM for Hibernate 4 to the project
* hibernate5 - Adds GORM for Hibernate 5 to the project
* json-views - Adds support for JSON Views to the project
* less-asset-pipeline - Adds LESS Transpiler Asset Pipeline to a Grails project
* markup-views - Adds support for Markup Views to the project
* mongodb - Adds GORM for MongoDB to the project
* neo4j - Adds GORM for Neo4j to the project
* rx-mongodb - Adds RxGORM for MongoDB to the project