移动开发
- 作者仓库星标 0
- 作者仓库 skills-registry
- 领域
- 人工智能
- 作者声明的智能体
- 未找到明确声明;不据此推断已兼容或已测试
- 静态检查
- 88 / 100 · 启发式扫描,不代表运行安全
- 运行环境证据
- 未执行;当前没有隔离运行测试证据
- 作者 / 版本 / 许可证
- @tomevault-io · 未声明许可证
- 上下文用量评级
- 低消耗
- 接入复杂程度
- 需简单配置
- 是否需要外部接口密钥
- 不需要
- 兼容的系统
- 未声明(默认跨平台)
- 运行环境要求
- 未检出明确要求
- 检测到的文件与系统行为
-
- 只读
- 命令执行
- 读取环境变量
- 网络行为
- 仅限本地
- 安装命令数
- 无(仅作为资料)
需要注意: 未声明工具权限范围;实际权限由运行环境决定。
# Mobile Development
## Stack
Expo 54, React Native 0.81, expo-router (file-based routing), Tamagui v4 (UI), TypeScript strict mode.
## Local Build Prerequisites
Required to run `expo run:android` or `expo prebuild`:
| Requirement | Check | Install |
|---|---|---|
| Java JDK 17 | `java -version` (must show `17.x`) | `brew install openjdk@17` |
| Android SDK | `echo $ANDROID_HOME` (must be set) | `mise run install` |
If `expo run:android` fails with a Java error:
```bash
brew install openjdk@17
export JAVA_HOME="$(brew --prefix openjdk@17)/libexec/openjdk.jdk/Contents/Home"
export PATH="$JAVA_HOME/bin:$PATH"
```
If `expo run:android` fails with `ANDROID_HOME not set` or SDK not found:
```bash
export ANDROID_HOME="$HOME/Library/Android/sdk"
export PATH="$ANDROID_HOME/emulator:$ANDROID_HOME/platform-tools:$PATH"
```
Both are set permanently by `mise run install`. If missing, re-run it or add to `~/.zshrc` manually.
iOS builds require Xcode (App Store). No additional toolchain needed beyond Xcode.
## Imports
Use `@/` path alias for project root: `@/lib/supabase`, `@/lib/posthog`.
## UI Components
Use Tamagui components with shorthand props. Never use raw React Native `View`/`Text`.
```tsx
// ✅
import { YStack, XStack, Text, Button, Card, Spinner, ScrollView } from 'tamagui';
<YStack gap="$4" p="$4">
<Text fos="$6" fow="bold">Title</Text>
<Button>Action</Button>
</YStack>
// ❌
import { View, Text } from 'react-native';
```
Common shorthand: `bg` (background), `p`/`px`/`py` (padding), `m`/`mt` (margin), `br` (borderRadius), `bw` (borderWidth), `boc` (borderColor), `fos` (fontSize), `fow` (fontWeight), `col` (color), `ai` (alignItems), `jc` (justifyContent), `gap`, `elevate`, `bordered`.
## Routing
File-based via expo-router:
- `app/_layout.tsx` — layout wrappers (Stack, Tabs)
- `app/index.tsx` — home screen
- `app/settings.tsx` — named route
Use `Stack` with `headerShown: false` (current convention).
## New Screen
```tsx
import { YStack, Text } from 'tamagui';
export default function MyScreen() {
return (
<YStack f={1} ai="center" jc="center" bg="$background">
<Text>My Screen</Text>
</YStack>
);
}
```
## Supabase
```tsx
import { supabase } from '@/lib/supabase';
```
Single shared client. Uses `EXPO_PUBLIC_SUPABASE_URL` and `EXPO_PUBLIC_SUPABASE_PUBLISHABLE_KEY`.
## Theme
Default theme is `dark`. TamaguiProvider wraps the app in `_layout.tsx` with `defaultTheme="dark"`.
## Environment Variables
All public config uses `EXPO_PUBLIC_*` prefix. Access via `process.env.EXPO_PUBLIC_*`.
---
> Source: [Ampli-Group/agentic-mobile-blueprint](https://github.com/Ampli-Group/agentic-mobile-blueprint) — distributed by [TomeVault](https://tomevault.io).
<!-- tomevault:4.0:skill_md:2026-05-22 -->
章节与文件索引
按说明文件中的顺序排列。
堆栈
本地构建先决条件
进口
用户界面组件
路由
文件/命令 -> expo run:android · expo prebuild · java -version · 17.x · brew install openjdk@17 · echo $ANDROID_HOME · mise run install · ANDROID_HOME not set
内容校验值 -> ce5b8f7558f5
当前原文的自动摘译,尚未人工审校。
堆栈
Expo 54、React Native 0.81、expo-router(基于文件的路由)、Tamagui v4(UI)、TypeScript 严格模式。
本地构建先决条件
运行
expo run:android或expo prebuild所需: 要求·检查·安装Java JDK 17·java -version(必须显示17.x)·brew install openjdk@17Android SDK·echo $ANDROID_HOME(必须设置)·mise run install如果expo run:android因Java错误而失败:进口
使用
@/路径别名作为项目根目录:@/lib/supabase、@/lib/posthog。用户界面组件
将 Tamagui 组件与简写 props 结合使用。切勿使用原始 React Native
View/Text。常用简写:bg(背景)、p/px/py(填充)、m/mt(边距)、br(边框半径)、bw(边框宽度)、boc(边框颜色)、fos(字体大小)、fow(字体粗细)、col(颜色)、ai(对齐项目)、jc(对齐内容)、gap、elevate、bordered。路由
通过 expo-router 基于文件:
app/_layout.tsx— 布局包装器(堆栈、选项卡)app/index.tsx— 主屏幕app/settings.tsx— 命名路由 将Stack与headerShown: false(当前约定)一起使用。