create-an-application.md - royale-docs - Git at Google

 ---
 # Licensed to the Apache Software Foundation (ASF) under one or more
 # contributor license agreements.  See the NOTICE file distributed with
 # this work for additional information regarding copyright ownership.
 # The ASF licenses this file to You under the Apache License, Version 2.0
 # (the "License"); you may not use this file except in compliance with
 # the License.  You may obtain a copy of the License at
 #
 # http://www.apache.org/licenses/LICENSE-2.0
 #
 # Unless required by applicable law or agreed to in writing, software
 # distributed under the License is distributed on an "AS IS" BASIS,
 # WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
 # See the License for the specific language governing permissions and
 # limitations under the License.

 layout: docpage
 title: Create an Application
 description: Building your first Apache Royale application
 permalink: /create-an-application
 ---

 # Create an Application

 Building your first Apache Royale application

 The easiest way to create an [Apache Royale](https://royale.apache.org/) application is to start with an existing one and modify it.  In the examples folder are several examples you can use as a starting point.  But if you want to know more about the underlying principles, read on.

 This document is divided into several sections:

 [Application Structure](create-an-application/application-structure) explains the important files that typically comprise an application and what they do.

 [Application Tutorial](create-an-application/application-tutorial) is a step-by-step example of building an application.

 [Migrate an Existing App](migrate-an-existing-app) provides strategies and techniques when migrating existing Flex apps to Royale, and how to switch to Royale if you already have a JavaScript application.

 [Security](create-an-application/security) provides more information about making sure hackers can't use your app to be malicous and about dealing with common security restrictions when your app wants to access external resources.

 [Modules](features/modules) discusses how to break your application into pieces so it doesn't have to all get downloaded at once.  Or have the whole thing compiled at once.

 [Optimizations](create-an-application/optimizations) explains some of the compiler settings and in-code doc comment directives that can be used to tune the output of javascript that Royale generates.
	---
	# Licensed to the Apache Software Foundation (ASF) under one or more
	# contributor license agreements. See the NOTICE file distributed with
	# this work for additional information regarding copyright ownership.
	# The ASF licenses this file to You under the Apache License, Version 2.0
	# (the "License"); you may not use this file except in compliance with
	# the License. You may obtain a copy of the License at
	#
	# http://www.apache.org/licenses/LICENSE-2.0
	#
	# Unless required by applicable law or agreed to in writing, software
	# distributed under the License is distributed on an "AS IS" BASIS,
	# WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
	# See the License for the specific language governing permissions and
	# limitations under the License.

	layout: docpage
	title: Create an Application
	description: Building your first Apache Royale application
	permalink: /create-an-application
	---

	# Create an Application

	Building your first Apache Royale application

	The easiest way to create an [Apache Royale](https://royale.apache.org/) application is to start with an existing one and modify it. In the examples folder are several examples you can use as a starting point. But if you want to know more about the underlying principles, read on.

	This document is divided into several sections:

	[Application Structure](create-an-application/application-structure) explains the important files that typically comprise an application and what they do.

	[Application Tutorial](create-an-application/application-tutorial) is a step-by-step example of building an application.

	[Migrate an Existing App](migrate-an-existing-app) provides strategies and techniques when migrating existing Flex apps to Royale, and how to switch to Royale if you already have a JavaScript application.

	[Security](create-an-application/security) provides more information about making sure hackers can't use your app to be malicous and about dealing with common security restrictions when your app wants to access external resources.

	[Modules](features/modules) discusses how to break your application into pieces so it doesn't have to all get downloaded at once. Or have the whole thing compiled at once.

	[Optimizations](create-an-application/optimizations) explains some of the compiler settings and in-code doc comment directives that can be used to tune the output of javascript that Royale generates.