Expo Material 3 主题配置指南

1. 项目基础介绍

Expo Material 3 Theme 是一个开源项目，它允许开发者从 Android 12+ 设备中获取 Material 3 动态主题，并在expo（或原生 React Native）应用中使用它。对于不兼容的设备（iOS 或旧版本的 Android），它会返回一个备选主题。

主要编程语言：JavaScript/TypeScript

2. 项目使用的关键技术和框架

• React Native: 用于构建原生移动应用的框架。
• Expo: 一个用于开发、构建和部署 React Native 应用的工具集。
• Material Design: 谷歌推出的一套设计语言，用于创建一致和美观的用户界面。

3. 项目安装和配置

准备工作

在开始之前，请确保你的开发环境中已经安装以下工具：

• Node.js：JavaScript 运行时环境。
• npm：Node.js 包管理工具。
• Expo CLI：用于创建和管理 Expo 项目。

安装步骤

步骤 1: 创建一个新的 Expo 项目

如果你还没有创建一个 Expo 项目，可以使用以下命令创建一个新的项目：

expo init MyNewProject
cd MyNewProject

步骤 2: 安装 Expo Material 3 Theme

在项目目录中，运行以下命令来安装 Expo Material 3 Theme：

npm install @pchmn/expo-material3-theme

如果你使用的是 Expo managed workflow，你需要继续以下步骤：

expo prebuild --platform android

然后构建你的 Android 开发版本：

expo run:android

对于使用 bare React Native 的项目，确保你已经安装和配置了 Expo，然后按照上述命令进行安装。

步骤 3: 使用主题

在你的应用中，你可以使用 useMaterial3Theme 钩子来获取和使用主题。以下是一个基本的用法示例：

import { useMaterial3Theme } from '@pchmn/expo-material3-theme';
import { useColorScheme, View, Button } from 'react-native';

function App() {
  const colorScheme = useColorScheme();
  const { theme } = useMaterial3Theme({ fallbackSourceColor: '#6750A4' });

  return (
    <View style={{ backgroundColor: theme[colorScheme].background }}>
      <Button color={theme[colorScheme].primary}>
        Themed button
      </Button>
    </View>
  );
}

这个例子中，useMaterial3Theme 钩子会根据系统的颜色方案返回一个主题对象。你也可以传递一个自定义的颜色来生成基于该颜色的主题。

按照以上步骤，你就可以在你的 React Native 应用中安装和配置 Expo Material 3 Theme 了。