移动模式
- 作者仓库星标 0
- 作者仓库 skills-registry
- 领域
- 工程开发
- 作者声明的智能体
- 未找到明确声明;不据此推断已兼容或已测试
- 静态检查
- 88 / 100 · 启发式扫描,不代表运行安全
- 运行环境证据
- 未执行;当前没有隔离运行测试证据
- 作者 / 版本 / 许可证
- @tomevault-io · 未声明许可证
- 上下文用量评级
- 低消耗
- 接入复杂程度
- 即装即用
- 是否需要外部接口密钥
- 不需要
- 兼容的系统
- macOS
- 运行环境要求
- 未检出明确要求
- 检测到的文件与系统行为
-
- 只读
- 网络行为
- 仅限本地
- 安装命令数
- 无(仅作为资料)
需要注意: 未声明工具权限范围;实际权限由运行环境决定。
# Mobile Patterns
> ⚠️ EXPERIMENTAL — Ainda não validado em produção.
## Quando Usar
- Implementar features em React Native, Flutter, Swift ou Kotlin
- Configurar builds para iOS e Android
- Resolver problemas específicos de plataforma
- Adaptar componentes web para comportamento mobile
## Padrões Fundamentais
### Performance Mobile
- Evitar re-renders em listas longas: usar `FlatList` (RN) ou `ListView.builder` (Flutter) — nunca renderizar tudo de uma vez
- Imagens: usar CDN, tamanhos otimizados, lazy loading
- Animações: rodar na thread nativa, não na JS thread (React Native: `useNativeDriver: true`)
- Evitar operações síncronas pesadas na main thread
### Navegação
- Separar navegação de lógica de negócio
- Gerenciar deep links com atenção a segurança (validar parâmetros)
- Preservar estado de scroll e posição ao voltar de screens
### Offline e Conectividade
- Detectar estado de rede antes de operações críticas
- Implementar retry com backoff para chamadas de API
- Cache local para dados frequentemente acessados
- Sincronização de dados offline com conflito handling
### Segurança Mobile
- Nunca armazenar secrets ou tokens no código
- Usar Keychain (iOS) ou Keystore (Android) para dados sensíveis
- Certificate pinning para APIs críticas
- Ofuscação de código em builds de produção
### Build e Deploy
```bash
# React Native — build Android
cd android && ./gradlew assembleRelease
# React Native — build iOS
xcodebuild -workspace ios/App.xcworkspace -scheme App -configuration Release
# Flutter — build
flutter build apk --release
flutter build ios --release
```
## Checklist Pré-Release
- [ ] Testado em dispositivo real (não só emulador)
- [ ] Testado nos tamanhos de tela principais
- [ ] Permissões solicitadas com justificativa clara
- [ ] Deep links testados
- [ ] Performance em dispositivos de baixo desempenho
- [ ] Sem dados sensíveis em logs de produção
- [ ] Build assinado com certificado correto
## Passos
### 1. Identificar a plataforma alvo
- **React Native**: JavaScript/TypeScript, código compartilhado iOS+Android
- **Flutter**: Dart, alta fidelidade visual multiplataforma
- **Swift/SwiftUI**: iOS/macOS nativo
- **Kotlin/Jetpack Compose**: Android nativo
### 2. Mapear os padrões fundamentais necessários
Consultar `## Padrões Fundamentais` para identificar quais aplicam:
- Navegação (Stack, Tab, Drawer)
- Gerenciamento de estado
- Requisições HTTP e cache
- Armazenamento local
### 3. Implementar com padrões da plataforma
- Seguir as **Human Interface Guidelines** (iOS) ou **Material Design** (Android)
- Componentes nativos sempre que possível (evitar custom widgets desnecessários)
- Adaptar layout para diferentes tamanhos de tela (`SafeAreaView`, responsive units)
### 4. Validar em dispositivo real
- Testar em iOS e Android (não só em emulador)
- Verificar orientação portrait e landscape
- Testar com conectividade ruim e offline
### 5. Completar o checklist antes de release
Usar `## Checklist Pré-Release` antes de submeter para as stores.
## Exemplos
### React Native — Componente com estados de loading/error
```tsx
function ListaPedidos() {
const { data, isLoading, error } = usePedidos()
if (isLoading) return <ActivityIndicator size="large" />
if (error) return <ErrorState message={error.message} onRetry={refetch} />
if (!data?.length) return <EmptyState message="Nenhum pedido encontrado" />
return (
<FlatList
data={data}
keyExtractor={(item) => item.id}
renderItem={({ item }) => <PedidoCard pedido={item} />}
/>
)
}
```
### Flutter — Tratamento de estado com riverpod
```dart
final pedidosProvider = FutureProvider<List<Pedido>>((ref) async {
return ref.watch(pedidoRepositoryProvider).listarPedidos();
});
class PedidosScreen extends ConsumerWidget {
@override
Widget build(BuildContext context, WidgetRef ref) {
final pedidosAsync = ref.watch(pedidosProvider);
return pedidosAsync.when(
loading: () => const CircularProgressIndicator(),
error: (err, _) => Text('Erro: $err'),
data: (pedidos) => ListView.builder(
itemCount: pedidos.length,
itemBuilder: (ctx, i) => PedidoTile(pedido: pedidos[i]),
),
);
}
}
```
---
> Source: [ATNexusLab/skills](https://github.com/ATNexusLab/skills) — distributed by [TomeVault](https://tomevault.io).
<!-- tomevault:4.0:skill_md:2026-05-22 -->
章节与文件索引
按说明文件中的顺序排列。
何时使用
性能移动
导航
离线和连接
移动安全
文件/命令 -> FlatList · ListView.builder · useNativeDriver: true · ## Padrões Fundamentais · SafeAreaView · ## Checklist Pré-Release
内容校验值 -> bfea778901a2
当前原文的自动摘译,尚未人工审校。
何时使用
在 React Native、Flutter、Swift 或 Kotlin 中实现功能 配置 iOS 和 Android 的构建 解决特定于平台的问题 调整 Web 组件以适应移动行为
性能移动
避免在长列表中重新渲染:使用
FlatList(RN)或ListView.builder(Flutter)——永远不要一次渲染所有内容图像:使用CDN,优化尺寸,延迟加载动画:在本机线程中运行,而不是在JS线程中(React Native:useNativeDriver: true)避免在主线程中进行繁重的同步操作导航
将导航与业务逻辑分开 管理深层链接并注意安全性(验证参数) 从屏幕返回时保留滚动状态和位置
离线和连接
在关键操作之前检测网络状态 对 API 调用实施带回退的重试 对频繁访问的数据进行本地缓存 通过冲突处理进行离线数据同步
移动安全
切勿在代码中存储机密或令牌 使用 Keychain (iOS) 或 Keystore (Android) 存储敏感数据 关键 API 的证书固定 生产版本中的代码混淆