This documentation is available as Markdown for AI agents and LLMs. See the full Markdown index or append .md to any documentation URL.

创建你的第一个应用

编辑页面

在本章中,指示你的 AI 代理创建一个新的 Expo 应用,并在你的手机上查看它运行。


在这一章中,你的代理会创建一个新的 Expo 应用,你会在手机上运行它,并进行第一次修改。这就是你在本教程剩余部分会反复执行的循环。

1

在新文件夹中启动你的代理

你的代理一次只在一个文件夹内工作,因此为这个项目创建一个专用文件夹,并在其中启动代理。在终端中运行:

Terminal
- mkdir StickerSmash

- cd StickerSmash

然后在该文件夹中启动你的代理:运行 claude 或 codex。如果你使用的是 Cursor,创建一个名为 StickerSmash 的新文件夹,用 File > Open Folder 将其打开,然后打开代理面板。

2

创建应用

将以下提示粘贴到你的代理中:

Prompt
Create a new Expo app in this folder (the current directory) by running npx create-expo-app@latest and choosing the SDK 57 template — I will test the app with Expo Go on my phone, which uses SDK 57. After it is created, run the project's reset-project script so we start from a minimal app, and delete the example folder that the script leaves behind. Don't start the development server; I will run that myself.

代理需要几分钟来下载模板并安装其依赖项。完成后,它应该会报告项目已就绪,并包含一个只有几个文件的精简 src/app 文件夹。

3

在手机上运行应用

这是你在本教程中自己会运行的唯一命令。它会启动开发服务器,将你的应用流式传输到手机上。打开一个新的终端窗口(让你的代理继续运行在第一个窗口中),然后运行:

Terminal
- cd StickerSmash

- npx expo start

终端中会出现一个二维码。要打开应用:

  • Android:打开 Expo Go,然后点击 Scan QR code。
  • iOS:打开默认相机应用,并将其对准二维码。

你应该会在手机上看到一个几乎空白的屏幕。那就是你的应用。在本教程剩余部分,请保持此终端窗口打开,并将手机放在身边。

手机无法连接?

你的手机和电脑必须连接到同一个 Wi-Fi 网络。如果已经连接但应用仍然无法加载,请用 Ctrl + C 停止服务器,然后以隧道模式重新启动,这种方式可跨网络工作:

Terminal
- npx expo start --tunnel

当你在手机和终端中登录同一个 Expo 账户时,也可以在 Expo Go 的 Projects 选项卡下找到你的项目。

4

做出你的第一次修改

现在把这个循环闭合起来:向代理请求一个可见的变化,并观察它出现在你的手机上。将以下提示粘贴到你的代理中:

Prompt
将主页屏幕改为在深色背景 #25292e 上显示白色、居中的文本 "Home screen"。

你应该看到的效果:在代理完成后的几秒内,你手机上的应用会重新加载,显示一个深色屏幕,中间有白色的 "Home screen" 文本:

这就是整个工作流程——你提出需求,代理构建,手机显示结果。

当某些东西看起来不对时

迟早会有结果和你要求的不一致。这很正常,修正它也是工作流程的一部分:

  • 描述,不要诊断。 直接告诉代理你看到了什么,以及你期望看到什么:“文本是居中的,但背景仍然是白色。” 你不需要去猜原因。
  • 逐字粘贴错误信息。 如果你的手机显示红色错误屏幕,或者终端打印出错误,把完整消息复制给代理。错误信息是写给程序员看的,而你的代理也是。
  • 让代理检查它的工作。 像“有些地方坏了——请检查你刚刚做的更改,找出问题并修复它”这样的提示会很有帮助。
  • 如果应用卡住了,摇一摇手机,然后在出现的菜单中点按 Reload。如果这还不行,使用 Ctrl + C 停止开发服务器,然后再次运行 npx expo start。

接下来的章节末尾都会有一个简短的提醒,链接回本节。

摘要

Chapter 2: Create your first app

You created an app, ran it on your phone, and changed it with a single prompt.

In the next chapter, you'll turn this empty screen into the real thing: navigation tabs, the photo viewer, and an image picker.

Next: Chapter 3: Build the home screen