App #

On this page you find the documentation for the App class.

Introduction #

The App class represents the entire app the user can interact with. It is used to:

• Keep track of the app's global state through the app's instance variables
• Create the first page shown to the user

You should create your own class inheriting from App and in which you override some methods to give your own app the specific behavior you want it to have, as shown below.

// Name your own app whatever you want.
class MyApp extends App{
	// Override methods here to give your own app
	// the specific behavior you want it to have.
}

Initializing the global state #

When the user starts using your app, a new instance of your App class will be created, and the method onBefore() will be called. In this method you can initialize any global state you need to use in your app.

class MyApp extends App{
	onBefore(){
		this.startTime = Date.now()
		this.playerRemainingLives = 3
	}
}

Creating the start page #

After onBefore() has been called, createStartPage() will be called. In this method, you should create and send back an instance of the Page class that should first be shown to the user. This method you must implement, otherwise your app won't know how to start.

class MyApp extends App{
	createStartPage(){
		return new StartPage()
	}
}

class StartPage extends Page{
	// Override methods here to give this page
	// the specific behavior you want it to have.
}

See the documentation for the Page class to learn which methods you can override in it.

Speaking the text #

You can make the app speak the text in Text components using the speakers on the user's device by enabling the app's Mouth with the code a.mouth.enable().

class MyApp extends App{
	onBefore(){
		a.mouth.enable()
	}
	createStartPage(){
		return new StartPage()
	}
}

class StartPage extends Page{
	createGui(){
		return (
			Button(`Go to TextPage`).page(TextPage)
		)
	}
}

class TextPage extends Page{
	createGui(){
		return Rows(
			Text(`Hi there, how are you doing?`),
			Button(`Back to ButtonPage`).page(StartPage),
			Text(`Are you doing fine?`),
		)
	}
}

The app's voice can also be configured and disabled. Check out the documentation for the Mouth class for more information.