XANDApp开发教程,从零开始构建你的跨平台应用

npm install -g xandapp-cli

--template参数支持多种预设模板（如tabs、gallery等），新手推荐从blank空白模板开始，快速理解项目结构，创建完成后，进入项目目录（cd my-first-app），你会看到核心文件：

• src/：源代码目录，包含页面、组件、工具类等；
• public/：静态资源（图片、字体等）；
• xandapp.config.js：项目配置文件，可设置应用名称、图标、权限等。

开发核心：页面与组件化开发

XANDApp采用声明式UI语法，类似React，通过XML/JSX描述界面，结合JavaScript/TypeScript编写业务逻辑。

页面开发

在src/pages/下创建新页面（如home.js），XANDApp要求每个页面导出default组件：

// src/pages/home.js
import { View, Text, Button } from 'xandapp';  
export default function Home() {  
  const handlePress = () => {  
    console.log('Button clicked!');  
  };  
  return (  
    <View style={styles.container}>  
      <Text style={styles.title}>Hello XANDApp!</Text>  
      <Button title="Click Me" onPress={handlePress} />  
    </View>  
  );  
}  
const styles = {  
  container: { flex: 1, justifyContent: 'center', alignItems: 'center' },   { fontSize: 24, marginBottom: 20 }  
};  

路由配置

在src/app.js中配置路由，实现页面跳转：

// src/app.js
import { Router, Stack } from 'xandapp';  
import Home from './pages/home';  
import About from './pages/about';  
export default function App() {  
  return (  
    <Router>  
      <Stack initialRoute="home">  
        <Home path="home" />  
        <About path="about" />  
      </Stack>  
    </Router>  
  );  
}  

原生能力调用：打通平台边界

XANDApp通过原生模块（Native Modules）封装了设备摄像头、地理位置、文件系统等能力，开发者无需编写原生代码即可调用，调用相机拍照：

import { Camera } from 'xandapp';  
const takePhoto = async () => {  
  const result = await Camera.launch({  
    type: 'camera',  
    mediaType: 'photo'  
  });  
  if (result.uri) {  
    console.log('Photo taken:', result.uri);  
  }  
};  

若需自定义原生能力，可通过XANDApp的插件机制扩展（需参考官方文档编写Android/iOS原生代码）。

调试与发布：从测试到上线

• 调试：XANDApp支持实时热重载（Hot Reload），修改代码后自动刷新应用，在开发阶段，可通过xandapp run android/ios命令启动模拟器或真机调试，日志通过Chrome DevTools查看（默认端口8080）。
• 打包发布：执行xandapp build android --release生成Android APK（需配置签名密钥），或xandapp build ios --release生成iOS IPA（需Apple开发者证书）。

进阶技巧：优化与扩展

• 性能优化：避免在render中创建新函数，使用useMemo缓存计算结果；大列表渲染采用FlatList组件提升滚动性能。
• 主题定制：通过xandapp.config.js中的theme字段全局定义颜色、字体，或通过ThemeProvider组件实现局部主题切换。

XANDApp以其“一次开发，多端运行”的特性，让开发者能快速聚焦业务逻辑，而非跨平台兼容性问题，结合丰富的文档与社区支持，无论是个人开发者还是团队，都能高效构建高质量的跨平台应用，如果你对原生性能有更高要求，还可结合原生模块进一步优化,打造接近原生体验的应用。