用途:当需要把第三方库或服务集成进 Expo 应用时,可参考 expo/examples 官方示例库。该库包含约 70 个以 with-<library> 命名的目录(如 with-stripe、with-maps),每个围绕一个库或服务。它们不是完整应用,而是托管项目(无 ios/、android/ 目录,原生配置通过 config plugins 完成),典型示例只有约 100–200 行的单屏代码,适合提取依赖集合、app.json 配置插件和最小接线方式,再适配到用户项目,不宜照搬应用架构。
主要能力与用法:两种模式。灵感/适配模式(最常见):用户已有项目,找到匹配示例,阅读关键文件后手工套用模式,不要在用户项目上脚手架。脚手架模式:全新项目可直接从示例创建,命令为 npx create-expo --example with-stripe(简写 npx create-expo -e with-stripe),或 bun create expo --example with-stripe。
查找示例:可用 gh api repos/expo/examples/contents --jq '.[] | select(.type=="dir" and (.name|startswith(".")|not)) | .name' 列出实时名称;用 gh api repos/expo/examples/contents/meta.json --jq '.content' | base64 -d 查看重命名(aliases)与已废弃(deprecated)示例,废弃项不应推荐。阅读文件时优先 README.md、package.json、app.json、集成代码和 .env;文件较多时可把整个示例拉到临时目录(如 npx degit expo/examples/with-stripe /tmp/expo-ref/with-stripe)再阅读。
适配要点:不要复制固定版本,用 npx expo install <pkg> 安装 SDK 匹配版本;合并而非替换 app.json/app.config.* 配置;移植集成代码;按示例 .env 结构重建环境变量。注意默认分支是 master 而非 main。每个示例有单键部署链接 https://launch.expo.dev/?github=https://github.com/expo/examples/tree/master/<example>。
限制:仅在任务明确匹配其上游产品或 API 范围时使用;命令、API 行为、价格、配额、凭据和部署影响需以当前官方文档为准;生成的示例不能替代环境相关测试、安全审查或对破坏性/高成本操作的用户批准。相关技能包括 expo-tailwind-setup、building-native-ui、expo-module、upgrading-expo。