移动开发

人工智能 社区

技能解读

当前原文的自动摘译,尚未人工审校。

堆栈

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 (当前约定)一起使用。

流狐档案 运行与权限由流狐静态检查推断,不代表作者声明或实际测试结果。
领域
人工智能
作者声明的智能体
未找到明确声明;不据此推断已兼容或已测试
静态检查
88 / 100 · 启发式扫描,不代表运行安全
运行环境证据
未执行;当前没有隔离运行测试证据
作者 / 版本 / 许可证
@tomevault-io · 未声明许可证
上下文用量评级
低消耗
接入复杂程度
需简单配置
是否需要外部接口密钥
不需要
兼容的系统
未声明(默认跨平台)
运行环境要求
未检出明确要求
检测到的文件与系统行为
  • 只读
  • 命令执行
  • 读取环境变量
网络行为
仅限本地
安装命令数
无(仅作为资料)

需要注意: 未声明工具权限范围;实际权限由运行环境决定。

作者说明文件(原文) SKILL.md

# 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 -->

讨论

基于 GitHub Discussions。登录 GitHub 即可参与讨论、点赞、订阅更新。