ice/website/docs/guide/basic/app.md

---
title: 应用入口
order: 4
---

ice.js 通过应用配置的方式渲染整个应用，开发者可以根据提供的配置定制应用。

## 应用配置文件

框架以 `src/app.ts` 作为应用配置文件：

```ts
import { defineAppConfig } from 'ice';

export default defineAppConfig(() => ({
  app: {
    strict: true,
  },
}));
```

> 推荐通过 `defineAppConfig()` 的方式导出应用配置，以获得良好的类型提示。

## 配置项

应用入口的配置项，支持应用常用的相关配置。

### app

#### `rootId`

根节点 id

- 类型：`string`
- 默认值：`ice-container`

:::tip
小程序端不支持修改 rootId。
:::

#### `strict`

是否开启 React 的严格模式 (React.StrictMode)

- 类型：`boolean`
- 默认值：`false`

#### `errorBoundary`

是否启用内置的错误边界捕获能力

- 类型：`boolean`
- 默认值：`false`

### router

:::tip
小程序端不支持 `router` 配置。关于小程序的 `router` 配置参考[小程序开发-路由](../miniapp/router)
:::

#### `type` 

路由类型

- 类型：`'hash' | 'browser' | 'memory'`
- 默认值：`browser`

:::tip

当设置路由类型为 `memory` 时，需要对应设置 [`initialEntries`](#initialentries)。

:::

#### `initialEntries`

路由类型设置为 [`MemoryRouter`](https://reactrouter.com/en/main/router-components/memory-router#memoryrouter) 时，需要渲染的路由。

- 类型：`InitialEntry[]`
- 默认值：`['/']`

```ts
import { defineAppConfig } from 'ice';

export default defineAppConfig(() => ({
  router: {
    type: 'memory',
    // 渲染 home 页面
    initialEntries: ['/home'],
  },
}));
```

#### `basename`

路由 basename

- 类型：`string`
- 默认值：`/`

## 运行时拓展

应用入口除了支持定义应用配置之外，同时也承担运行时扩展的能力，比如权限配置：

```js
import { defineAppConfig } from 'ice';
import { defineAuthConfig } from '@ice/plugin-auth/types';

// 导出 auth 相关的能力，该能力由 @ice/plugin-auth 插件提供
export const authConfig = defineAuthConfig(() => {
  return {
    initialAuth: {
      admin: true,
    },
  };
});

export default defineAppConfig(() => ({
  app: {
    strict: true,
  },
}));
```