东软集团Widget开发规范详解

"Widget开发规范文档，主要涵盖了Widget的JILFormat规范和编码规范，旨在为开发者提供清晰的开发指导。文档由广东移动办公项目组和东软集团有限公司共同制定，涉及的内容包括Widget的文件扩展名、zip文件、config文件、config.xml文件中的各项元素，如namespace、Widget、name、description、author、license、icon、content、feature、param、preference、span、access、maximum_display_mode、billing、update等。同时，文档也详细阐述了编码规范，包括文件命名、页面布局、Javascript编程的各方面细节，如缩进、行长度、注释、变量和函数声明、命名约定以及各种语句的使用规则。此外，还介绍了Widget配置文件的标准化和命名空间校验原则。" 在Widget开发JILFormat规范中，开发者必须遵循一系列检查步骤以确保Widget符合标准： 1. 文件扩展名：确保Widget文件使用正确的扩展名，通常是.zip。 2. Zip文件：检查zip包的完整性和格式，确保所有必需的文件都已包含。 3. Config文件：验证config文件的存在和格式，它是Widget配置的核心。 4. Config.xml文件内容：检查XML文件的结构，包括namespace、Widget、name、description、author、license等关键元素。 5. Namespace：确保每个Widget有其独特的命名空间，以区分不同开发者或公司的产品。 6. Widget、name、description、author、license：这些元素提供关于Widget的基本信息，如作者、描述、许可证等。 7. Icon：检查Widget的图标文件，通常用于用户界面展示。 8. Content：定义Widget的主要内容或入口点。 9. Feature：列出Widget所需的功能，如网络访问、地理位置等，需指定name属性的范围。 10. Param：配置Widget的参数，允许自定义设置。 11. Preference：定义可配置的用户首选项。 12. Span：控制Widget在不同屏幕尺寸上的显示方式。 13. Access：定义Widget的网络访问权限。 14. Maximum_display_mode：设定Widget的最大显示模式。 15. Billing：支持付费功能或内购服务的配置。 16. Update：设置Widget的更新策略。 17. 属性和标签的前缀：确保使用统一的命名约定，增加可读性。 18. 数字签名：为了安全，Widget可能需要进行签名验证。 在Widget编码规范部分，文档强调了良好的代码组织和风格： 1. 文件名：应遵循一致的命名规则，包括文件后缀。 2. 页面布局：遵循清晰、简洁的设计原则，优化用户体验。 3. Javascript规范：涵盖代码缩进、行长度限制、注释规范、变量和函数声明、命名约定，以及对各种语句（如if、for、while、switch、try-catch等）的使用规定。 4. 注释：鼓励添加清晰、有用的注释，以提高代码可读性。 5. 命名：提倡使用有意义、一致的命名，避免使用模糊或容易引起混淆的名称。 6. 代码风格：强调简洁、整洁的代码编写，包括避免冗余、减少复杂性，提高代码的可维护性。 Widget配置文件说明部分，强调了配置文件应遵循WAC标准，并提供命名空间校验原则，以确保跨平台兼容性和数据一致性。通过遵循这些规范，开发者可以创建高质量、易于维护的Widget应用，提升用户体验。