用途:面向 NativeScript 移动应用的开发规范与模式参考,帮助组织代码、优化布局与性能,并规避常见内存与渲染问题。
主要能力:给出代码风格与结构约定,建议用模块化组件和服务组织代码;当平台特定代码超过 20 行时使用 .ios.ts、.android.ts 平台文件;自定义原生代码采用 custom-native/index.ios.ts、custom-native/index.android.ts、custom-native/common.ts、custom-native/index.d.ts 结构;命名上以 ios 或 android 前缀标识平台特定变量,组件与样式名保持描述性。
使用方式:扩展原生类时使用 @NativeClass();iOS 自定义代理需声明 static ObjCProtocols = [AnyUIKitDelegate]; 并将代理实例保留在类作用域防止被垃圾回收;平台条件代码优先使用 ANDROID 与 APPLE 以支持 tree-shaking;使用 @nativescript/tailwind ^2.1.0 搭配 tailwindcss ~3.4.0,并配置 ios:、android: 变体及 darkMode: ['class', '.ns-dark'];布局优先 GridLayout 与 StackLayout,简单线性排列用 StackLayout,复杂布局用 GridLayout,隐藏但需保留占位的元素用 visibility: 'hidden';修改 App_Resources 或 package.json 后执行 ns clean。
适用场景:NativeScript 移动端项目的开发与重构,尤其涉及平台差异化代码、复杂布局、列表模板选择器、图像压缩与长时间运行应用的内存控制。
限制:资料未提供具体版本兼容范围、安装命令、收费或平台支持细节;部分示例涉及 Angular、React、Solid、Svelte、Vue 的状态管理与生命周期,需结合对应框架使用。