入口组件

每一个 Taro 应用都需要一个入口组件（React 组件）用来注册应用。入口文件默认是 src 目录下的 app.js。

在入口组件中我们可以设置全局状态或访问小程序入口实例的生命周期。

代码示例

• Class Component
• Functional Component

app.js

import React, { Component } from 'react'
// 假设我们要使用 Redux
import { Provider } from 'react-redux'
import configStore from './store'
// 全局样式
import './app.css'
const store = configStore()
class App extends Component {
  // 可以使用所有的 React 生命周期方法
  componentDidMount () {}
  // 对应 onLaunch
  onLaunch () {}
  // 对应 onShow
  componentDidShow () {}
  // 对应 onHide
  componentDidHide () {}
  render () {
    // 在入口组件不会渲染任何内容，但我们可以在这里做类似于状态管理的事情
    return (
      <Provider store={store}>
        {/* this.props.children 是将要被渲染的页面 */}
        {this.props.children}
      </Provider>
    )
  }
}
export default App

app.js

import React, { useEffect } from 'react'
// Taro 额外添加的 hooks 要从 '@tarojs/taro' 中引入
import { useDidShow, useDidHide } from '@tarojs/taro'
// 假设我们要使用 Redux
import { Provider } from 'react-redux'
import configStore from './store'
// 全局样式
import './app.css'
const store = configStore()
function App (props) {
  // 可以使用所有的 React Hooks
  useEffect(() => {})
  // 对应 onShow
  useDidShow(() => {})
  // 对应 onHide
  useDidHide(() => {})
  return (
    // 在入口组件不会渲染任何内容，但我们可以在这里做类似于状态管理的事情
    <Provider store={store}>
      {/* props.children 是将要被渲染的页面 */}
      {props.children}
    </Provider>
  )
}
export default App

入口组件配置

请参考 全局配置

生命周期方法

入口组件除了支持 React 的生命周期方法外，还根据小程序的标准，额外支持以下生命周期：

onLaunch (options)

在小程序环境中对应 app 的 onLaunch。

在此生命周期中通过访问 options 参数或调用 getCurrentInstance().router，可以访问到程序初始化参数。

参数

options

options.referrerInfo

options 参数的字段在不同小程序中可能存在差异，如：

场景值 scene，在微信小程序和百度小程序中存在区别，请分别参考 微信小程序文档 和 百度小程序文档

componentDidShow (options)

程序启动，或切前台时触发。

和 onLaunch 生命周期一样，在此生命周期中通过访问 options 参数或调用 getCurrentInstance().router，可以访问到程序初始化参数。

参数与 onLaunch 中获取的基本一致，但百度小程序中补充两个参数如下：

componentDidHide ()

程序切后台时触发。

onPageNotFound (Object)

程序要打开的页面不存在时触发。

参数

Object