---
url: /guide/basic/app.md
---
# 创建 App {#create-app}
Mpx 应用需要在 `app.mpx` 中调用 `createApp` 方法注册App实例，绑定生命周期回调函数、错误监听和页面不存在监听函数等。
## createApp
`createApp` 是 Mpx 提供的用于注册小程序实例的方法，它接受一个 Object 类型的参数，指定小程序的生命周期回调等。
```html
```
### 生命周期 {#lifecycle}
* **onLaunch(Object object)**
小程序初始化完成时触发，全局只触发一次。
* `object` (Object): 启动参数
* **onShow(Object object)**
小程序启动，或从后台进入前台显示时触发。
* `object` (Object): 启动参数
* **onHide()**
小程序从前台进入后台时触发。
* **onError(String error)**
小程序发生脚本错误或 API 调用报错时触发。
* `error` (String): 错误信息
* **onPageNotFound(Object object)**
小程序要打开的页面不存在时触发。
* `object` (Object): 页面不存在的详细信息
* **onUnhandledRejection(Object object)**
小程序有未处理的 Promise 拒绝时触发。
* `object` (Object): 拒绝的详细信息
* **onThemeChange(Object object)**
系统切换主题时触发。
* `object` (Object): 主题信息
## getApp
整个小程序只有一个 App 实例，是全部页面共享的。开发者可以通过 `getApp` 方法获取到全局唯一的 App 实例，获取 App 上的数据或调用开发者注册在 App 上的函数。
```js
// xxx.js
const appInstance = getApp()
console.log(appInstance.globalData) // I am global data
```
> **注意**
>
> * 不要在定义于 `App()` 内的函数中，或调用 `App` 前调用 `getApp()` ，使用 `this` 就可以拿到 app 实例。
> * 通过 `getApp()` 获取实例之后，不要私自调用生命周期函数。
## App 样式 {#app-style}
在 `app.mpx` 中定义的样式为全局样式，会作用于应用中的所有页面。
```html
```
> **注意**
>
> * 全局样式会影响所有页面，但页面局部样式（在页面的 `