为Android, iOS, 和网络构建和运行通用 React Industrial 应用程序的最快方式
📚 读取文档 二. 支助 在博客上多学点 二. 支助 为博览会CLI做出贡献
如果您喜欢使用此项目, 请确定会主演 GitHub Repo
这个 @expo/cli 软件包是应通过 expo 软件包,比如 npx expo start (或 npx expo 页:1.
npx expo
如果你喜欢使用该项目,请请在博览会GitHub Repo上亮相!
设计
这一国家行动倡议的目的如下:
- 作为启动本地开发服务器的最小接口,该服务器可以模拟一个生产EAS Updates服务器. 开发服务器是本地运行时间(Expo Go, Dev Client)和JS Bundler(Metro, Webpack)之间的代理服务器.
- 为了实现网络安全显示签名,比如AsyncStorage或权限,如果两者都需要https/SSL,我们需要一个经过认证的博览会账户。 这是我们唯一包括认证命令的原因
login, (中文(简体) ),logout, (中文(简体) ),whoami, (中文(简体) ),register。标准网络CLI没有认证命令,因为他们要么没有设置https,要么通过软件包模拟devcert。 。 。 .
- 为了实现网络安全显示签名,比如AsyncStorage或权限,如果两者都需要https/SSL,我们需要一个经过认证的博览会账户。 这是我们唯一包括认证命令的原因
- Xcode等各种本土工具的管弦,
Simulator.app,Android Studio,ADB等让本土建筑尽可能无痛.run:ios, (中文(简体) ),run:android命令. - 执行一个版本
prebuild命令,可以长期可靠地与项目一起工作。 Prebuild就像一个捆绑器 对于本地代码,它生成 机器人 财务报告和审定财务报表 欧斯 基于工程 Expo 配置的文件夹( X)应用程序.json) (中文(简体) ).npx expo config是辅助工具npx expo prebuild并用于调试/内测.
- 正在安装版本库
npx expo install这是纯粹出于必要性而诞生的最低限度的用途,因为在React Industrial的版本很难正确.
捐款
开发 CLI 运行( 默认监视模式) :
pnpm build
我们强烈建议为博览会的CLI设置一个化名,这样你就可以在电脑周围的项目中尝试. 打开你的 .zshrc (英语) 或其他配置文件并添加:
alias nexpo="/path/to/expo/packages/@expo/cli/build/bin/cli"
那就用这个 nexpo 喜欢 nexpo config。也可以设置调试版本 :
alias expo-inspect="node --inspect /path/to/expo/packages/@expo/cli/build/bin/cli"
那样你就可以运行它和参观 chrome://inspect/#devices 在克罗姆语中,并按下 "打开专用的 DevTools 为节点" 以获取一个调试器附于您的进程。 调试 CLI 时, 您会希望尽可能使工人禁用, 这将让所有代码运行在同一线索上, 这主要适用于 start 命令,即:. expo-inspect start --max-workers 0。 。 。 .
格式
- 一定要更新
CHANGELOG.md每个公关都会有变化。 您只需要添加消息, 我们的 GitHub bot 会自动建议在 diff 中添加您的姓名和 PR 编号 . - 结束
async函数与Async喜欢runAsync。这就是我们在世博会上的功能格式. - 丢出错误时, 总是选择
CommandError改为Error这有助于调试,使经验更加一致. - 利用统一的
Log模块代替console.log。 。 。 . - 在使用变量进行记录时,使用以下格式
Something happened (foo: bar, baz: foz)。 。 。 .- 避免其他格式,如
Something happened: bar, foz或者说Something happened: foo=bar, baz=foz。 。 。 .
- 避免其他格式,如
- 命令名称等主要 UI 组件(
expo start),论据(--port),以及--help电文应在内部修改,由博览会团队负责,以确保开发者的经验在整个博览会工具中统一。 修改这些核心方面的外部捐款可能遭到拒绝. - 使用
profile与该工具的通用方法EXPO_PROFILE=1用于测量执行时间的环境变量. - 避免全球性的和单子的试验,因为这些使试验更难,更不可预测。 我们(在编写本报告时)唯一的全球问题是:
isOffline布尔.
环境
- 始终小心依赖的过渡性大小. 软件包恐惧症 用于确定软件包是否精益求精。 尽量减少CLI的依赖性.
- 我们利用
taskr+ 键swc,这个部分灵感来自Next.js的本地CLI. - 建设管道将把CLI版本内置为环境变量,在CLI代码库的任何地方都可以访问. 你可以通过
process.env.__EXPO_VERSION而不是读取本地package.json在运行时间. - 与传统全球博览会CLI不同的是,这种CLI是和
expo表示 SDK 版本始终存在 .- 减少 SDK 特定任务,因为只有一个 SDK 应计入一个版本
@expo/cli。 。 。 . - 这个
@expo/config方法getConfig无需skipSDKVersionRequirement在任何情况下,自从expo应始终安装。 实例:getConfig('...', { skipSDKVersionRequirement: true });不应该被使用.
- 减少 SDK 特定任务,因为只有一个 SDK 应计入一个版本
- 另外,与全球博览会CLI不同,我们可以假设,节点模块总是安装的,因为这个CLI应该通过项目的地方使用 节点( 模块) 文件夹.
- 这意味着我们无法进行升级操作
expo软件包,因为这些软件包可能会杀死运行的过程。 需要此模式的特征( 如expo upgrade(a) 应在独立的全球工具中生活.
- 这意味着我们无法进行升级操作
测试
有三种测试脚本:
pnpm test: 受控单位和集成测试pnpm test:e2e: 结束对 CLI 命令的测试pnpm test:playwright: 以 CLI 结束对 Expo SDK 的测试
- 您可以使用
--watch旗帜。 示例pnpm test --watch config。 。 。 . - 我们用回扣
it块。 示例it(。 。 。 .works) - 如果拉动请求完全自成一体
packages/@expo/cli/文件夹( 即无)pnpm-lock.yaml然后大多数本地CI测试会被跳过,使CI在PRs中通过得更快.
单位测试准则
- 使用
nock用于网络请求. - 无顶级
describe块将所有测试包入文件. - 测试函数时,将函数传递到
describe块而不是字符串函数名 :describe(foobar, () => {})改为describe('foobar', () => {})
- 使用虚拟
fs通过memfs只要可能,就应该. - 我们有很多全球模块 模拟 已经设置了, 在撰写测试时考虑它们 .
- GitHub 副驾驶可以让写作测试少一点乏味.
E2E 测试准则
- E2E测试应具有弹性和可靠性,确保为网络请求留出充足的时间.
- 在本地测试时,你必须 安装了套装。 。 。 .
- 当本地测试时, 您应该尝试重用节点模块, 以获得更快的结果 。 在那个
npx expo prebuild财务报告和审定财务报表npx expo start例如,我们使用一种默认重用项目+的帮助方法 节点( 模块) 当运行本地。 这可能是 已切换 {\fn黑体\fs22\bord1\shad0\3ahbe\4ah00\fscx67\fscy66\2chffffff\3ch808080}每一次 {\fn黑体\fs22\bord1\shad0\3ahbe\4ah00\fscx67\fscy66\2chffffff\3ch808080}把新项目绑起来. - 拖曳测试项目时,请使用临时文件夹
os.tmpdir()当计算机重新启动时,此文件夹会自动清理.
来自博览会CLI
TL; 大卫:
expo-cli是"让它工作",而@expo/cli是"做对了,快点".
全球遗产 expo-cli 软件包被折旧为赞成此版本 @expo/cli 软件包,原因如下:
expo-cli太大了 安装得太久了 这使得CI沮丧地建立起来,因为你还需要瞄准用于缓存的全球节点模块.expo-cli几乎所有版本的expo软件包,意思是每次发行都变得更加复杂.expo-cli合并服务命令( 如 遗留 )build, (中文(简体) ),submit, (中文(简体) ),publish),项目级命令类似expo start我们从此将服务分为eas-cli命令输入npx expo(单位:千美元)@expo/cli) (中文(简体) ). 这种结构对于开发者来说更为优化/快,因为他们可以在需要时安装/更新命令.- 这种CLI使用更多的Node.js标准特性,例如:
$EDITOR而不是习惯$EXPO_EDITOR环境变量。 也正在从$EXPO_DEBUG更接近于$DEBUG=expo:*。这些类型的修改使得 Expo CLI 与现有工具玩得更好. - DevTools UI已经被去皮化,以减少网络安装大小,将复杂度最小化,并为未来的调试UIs(Hermes/v8 Chrome debuger)留有空间.
- 这个
expo start:web财务报告和审定财务报表expo web命令已被滚入npx expo start现在我们懒散地装入平台,直到设备要求它们. - 其他缺失或β特征来自
expo-cli可能还是被迁移到这个新的CLI。 更详尽的细目,见 启动命令 PR。 。 。 .