DB43_T 2259-2021 信息技术应用创新工程建设规范 第10部分：应用开发通用技术要求.docx

《DB43_T 2259-2021 信息技术应用创新工程建设规范 第10部分：应用开发通用技术要求.docx》由会员分享，可在线阅读，更多相关《DB43_T 2259-2021 信息技术应用创新工程建设规范 第10部分：应用开发通用技术要求.docx（17页珍藏版）》请在淘文阁 - 分享文档赚钱的网站上搜索。

1、ICS01.140.20CCSL7043湖南省地方标准DB43/T22592021信息技术应用创新工程建设规范第10部分：应用开发通用技术要求EngineeringspecificationfortheApplicationInnovationProjectofInformationTechnologyPart10:Generaltechnicalrequirementsofapplicationdeveloping2021-12-29发布2022-03-29实施湖南省市场监督管理局发布DB43/T22592021目次前言引言1范围12规范性引用文件13术语和定义14缩略语25编码要求25.1

2、编程语言要求25.2函数命名要求25.3变量命名要求25.4国际化要求35.5变更日志要求36存储位置要求36.1可执行文件存储位置36.2动态库存储位置36.3配置文件存储位置36.4数据文件存储位置46.5缓存文件存储位置47日志要求47.1系统日志47.2应用日志48安全管理要求49软件包要求59.1软件打包要求59.2deb包具体要求59.3RPM包具体要求610桌面应用配置要求710.1desktop文件710.2icon文件710.3系统及应用服务要求711单进程要求711.1多用户单进程711.2单用户单进程8IDB43/T2259202111.3特殊访问单进程812多进程要求8

3、12.1进程间通信要求812.2系统资源限制要求813兼容性要求8附录A（资料性）变更日志changelog文件格式9附录B（资料性）desktop文件格式示例10参考文献11IIDB43/T22592021引言湖南省为深入贯彻国家网络强国战略，全面落实中央有关文件精神，部署开展湖南省信息技术应用创新工程建设，保障全省各级党政机关关键信息基础设施信息安全和信息系统安全可靠运行。针对自主可控产品体系初具规模，但相关产品和工程实施标准规范还很缺乏的现状，为了规范工程建设，加速工程进度，扩大建设结果，同时有力提升自主可控产业发展水平，确保信息安全，由湖南省国家密码管理局作为业务主管单位、湖南省工业和

4、信息化厅作为技术归口单位，由中国人民解放军国防科技大学、中国电子信息产业集团有限公司等单位与湖南省合作制定了信息技术应用创新工程建设规范地方标准。信息技术应用创新工程建设规范主要由自主可控核心产品、典型应用、工程管理等方面的规范组成，重点解决应用创新工程建设当中产品选型、应用开发、工程实施等基础环节的实际问题，可为应用创新工程的用户使用单位、集成建设单位和相关产品研制单位，在产品和应用规范化、软硬件兼容适配、工程实施标准等方面提供一般性指引。信息技术应用创新工程建设规范未来将根据自主可控产业和应用创新工程的发展变化进行相应的必要调整和补充。VDB43/T22592021VIDB43/T2259

5、2021信息技术应用创新工程建设规范第10部分：应用开发通用技术要求1范围本文件针对国产操作系统上应用开发的编码、软件配置及打包、日志、安全管理、软件包、桌面应用配置、单进程、多进程、兼容性等提出具体要求，有利于提高应用软件的兼容性。本文件适用于国产操作系统上第三方应用程序的开发，也为第三方应用程序的调试验证提供指导。2规范性引用文件下列文件中的内容通过文中的规范性引用而构成本文件必不可少的条款。其中，注日期的引用文件，仅该日期对应的版本适用于本文件；不注日期的引用文件，其最新版本（包括所有的修改单）适用于本文件。GB/T152721994程序设计语言CDB43/T1777.62020信息技术

6、应用创新工程建设规范第6部分：操作系统软件兼容性通用技术要求3术语和定义下列术语和定义适用于本文件。3.1驼峰命名法camelcase命名原则为第一个单词以小写字母开始，从第二个单词开始以后的每个单词的首字母都采用大写字母。3.2匈牙利命名法Hungariannotation命名原则是变量名=属性+类型+对象描述。3.3帕斯卡命名法Pascalcase命名原则是由二个或二个以上单词连结在一起，每个单词首字母大写，单字之间不以空格断开或连接号（-）、底线（_）连结，第一个单词首字母采用大写字母，后续单词的首字母亦用大写字母。3.4下划线命名法underscorecase命名原则是由二个或二个以上

7、单词连结在一起，每个单词用下划线隔开并且单词都是小写。3.5动态库dynamiclinklibrary一种不可执行的二进制程序文件，允许程序共享执行特殊任务所必需的代码和其他资源。1DB43/T225920213.6环境变量environmentvariables指在操作系统中用来指定操作系统运行环境的一些参数，如临时文件夹位置和系统文件夹位置等。3.7系统日志systemlog记录系统中硬件、软件和系统问题的信息，同时还可以监视系统中发生的事件。3.8软件包softwarepackage指具有特定的功能，用来完成特定任务的一个程序或一组程序。3.9变更日志changelog是对项目所作更改的

8、详细记录，通常包括修复和新功能。4缩略语下列缩略语适用于本文件：PNG：可移植的网络图形（PortableNetworkGraphics）SVG：可缩放的矢量图形（ScalableVectorGraphics）UTF：通用字符组/编码转换格式（UniversalCharacterSet/UnicodeTransformationFormat）5编码要求5.1编程语言要求应用软件开发应使用符合GB/T152721994要求的C语言，宜使用C+、Java、Python等语言实现。5.2函数命名要求开发人员在同一项目中应使用同一种命名规范命名函数，命名规范可采用驼峰命名法、匈牙利命名法、帕斯卡命名法

9、和下划线命名法中任意一种。5.3变量命名要求开发人员在同一项目中应使用同一种命名规范命名变量，命名规范可采用驼峰命名法、匈牙利命名法、帕斯卡命名法和下划线命名法中任意一种。变量命名还应遵守以下规则：a）在单独的代码行中声明每个变量；b）尽量避免使用简短或无意义的名称，例如“a”，“rbarr”；c）单字符变量名称只在临时变量或循环的计数中使用；d）在真正使用变量的时候定义变量；e）变量名称中的每个连续单词均以大写字母开头；f）避免使用缩写；g）类名以大写开头，公有类以Q开头，公有函数通常以q开头；2DB43/T22592021h）含首字母缩写的变量使用驼峰命名法，例如“QUkuiWindowM

10、anager”。5.4国际化要求编码中应遵守以下国际化规则：a）应支持BIG5、UTF-8编码格式的字符集；b）宜在源码中标识需要翻译的文本信息，使用lupdate生成.ts文件，使用翻译工具Linguist对.ts文件进行翻译，发布生成.qm二进制文件，通过在源码中加载.qm文件实现国际化。5.5变更日志要求每个版本应对应一条变更日志，变更日志中记录当前版本基于上一个版本改动的内容，变更日志changelog文件的格式应符合附录A的规定。6存储位置要求6.1可执行文件存储位置可执行文件的存储位置应符合以下要求：a）系统的可执行文件放在“/bin”目录下；b）系统软件的可执行文件放在“/usr

11、/bin/”目录下；c）用户的可执行文件放在“/usr/local/bin”目录下；d）应用软件的可执行程序放在“/opt/应用名/bin/”目录下。6.2动态库存储位置动态库的存储位置应符合以下要求：a）系统软件的动态库放在“/usr/lib”目录下；b）应用软件的动态库放在“/opt/应用名/lib”目录下：1）二进制编译时（包含可执行程序与动态链接库），加入链接器参数，将指定目录“/opt/应用名/lib”加入到rpath或runpath中；2）应用软件不应在运行时添加环境变量LD_LIBRARY_PATH来指定自定义的搜索路径。c）“/lib”和“/usr/lib”两个目录作为默认的库

12、搜索路径，使用其目录中的库时不需要设置搜索路径，其他处于默认库搜索路径之外的库，需要将库的位置添加到库的搜索路径中，设置库的搜索路径通过以下两种方式：1）在“/etc/ld.so.conf”文件中添加库的搜索路径,添加路径后运行/sbin/ldconfig命令更新“/etc/ld.so.cache”文件来设置库的搜索路径；2）在环境变量LD_LIBRARY_PATH中指明库的搜索路径。6.3配置文件存储位置配置文件的存储位置应符合以下要求:a）应用软件的全局配置文件放在“/etc/”目录下，如果一个应用软件有多个配置文件，则应建立“/etc/应用名/目录”，并将配置文件放入该目录；b）应用软件

13、的用户配置文件应统一放在“/home/用户名/.config/应用名/目录”下；c）应用软件不得直接修改系统配置，而应按照系统提供的方法新建自己的子配置，包括但不限于以下配置：3DB43/T225920211）登录后的环境变量配置，应放在“/etc/profile.d/”目录下，以“应用名.sh”命名；2）bash补全脚本，应放在“/etc/bash_completion.d/”目录下，以“应用名”命名；3）新建用户时的模板文件，应放在“/etc/skel/”目录下；4）AppArmor的配置文件，应放在“/etc/apparmor.d”目录下；5）cron定时配置，应放在“/etc/cron

14、.d/”目录下，以“应用名”命名，如果应用开发提供多个定时配置，则按照“应用名-功能名”命名。6.4数据文件存储位置数据文件的存储位置应符合以下要求：a）系统软件的数据文件存储路径应为“/var/lib/软件名”；b）应用软件的数据文件存储路径应为“/opt/应用名/”及其子目录，具体路径不做强制要求，可为“/opt/应用名/data/”。6.5缓存文件存储位置软件运行过程中产生的保存状态的缓存文件，应符合以下要求：a）系统软件的缓存文件存储路径应为“/var/cache/软件名/”；b）如果应用软件安装路径为“/opt/应用名/”，则应用软件的缓存文件存储路径应为“/opt/应用名/”目录及

15、其子目录，具体路径不做强制要求，可为“/opt/应用名/cache/”；c）如果应用软件安装路径为“/usr/share/应用名/”，则应用软件的缓存文件存储路径应为“/var/cache/应用名”目录及其子目录。7日志要求7.1系统日志系统日志应符合以下要求：a）日志输出不应影响系统正常运行；b）日志输出不应产生安全问题，不应输出敏感信息；c）日志使用应符合安全审计要求，支持备份和保密机制；d）日志可供系统开发和运维人员定位问题的原因；e）日志分为普通级、调试级、警告级、错误级和警报级5类。7.2应用日志应用日志应符合以下要求：a）循环体内不打印Info日志；b）打印日志打码，不应发生异常；

16、c）不应使用字符串拼接，宜使用占位符；d）日志文件至少保存15天。8安全管理要求应用开发的安全管理应符合以下要求：4DB43/T22592021a）具有前端交互逻辑的应用可执行程序，一般应以普通用户权限运行，不应使用sudo、pkexec等命令直接提权运行；b）如果应用需要特权态执行某些操作，应使用前后端分离的方式实现，前端含有交互逻辑的二进制程序使用普通用户权限运行，通过dbus等技术与后端具有管理员权限的服务端通讯，实现相关功能；c）如果前端应用使用dbus等技术与后端具有管理员权限的服务端通讯，应进行身份鉴别，用于确定用户是否具备该项行为的权限。9软件包要求9.1软件打包要求应用软件的打

17、包方式，应按照DB43/T1777.62020中6.5节要求执行。9.2deb包具体要求9.2.1版本号要求版本号的唯一性应适用于源码包和二进制包，在任何源码包下，二进制包不能重复使用。9.2.2控制文件包管理系统将控制数据存储在控制文件（control文件）中，控制文件应使用UTF-8编码，由一个或多个字段段落组成，每个段落中包含多个数据字段，每个字段由字段名、紧跟着的冒号和该字段的数据/值组成。一个段落不应出现一个字段有多个实例的情况。9.2.3软件包描述每个deb包的control文件中包括Description字段，该字段应包含软件包的概要和扩展描述，还应描述关键依赖和其它软件包的冲突

18、信息。Description字段不应包含配置或使用软件包的说明（即安装脚本、手册页、信息文件等），以及版权说明。9.2.4包变更日志每个源码包中均应包含变更日志文件（changelog文件），包变更日志文件使用UTF-8编码，deb包的变更应在changelog文件中作出简短说明，包括新的软件包对于上游软件包作出的修改、其它变更以及软件包的更新信息，变更日志changelog文件格式应符合附录A的规定。9.2.5编译脚本编译脚本是一个可执行的makefile文件，应以#!/usr/bin/make-f开头，便于使用名称调用而不是直接调用make。9.2.6重复构建要求为了实现重复构建，源码包的

19、构建应符合以下要求：a）在指定路径解压源码包；5DB43/T22592021b）已安装的构建依赖项版本；c）指定的环境参数值；d）确定构建架构；e）确定主机的CPU指令架构。9.2.7软件包维护者除了孤立软件包外，每个软件包都应有维护者，软件包的维护者应符合以下要求：a）维护者信息应在control文件的Maintainer字段中给出，包括名称和邮件地址；b）如果一个人或者一个团队维护几个软件包，则维护者的名称和邮箱应在这些软件包的Maintainer字段中统一格式；c）如果一个软件包的维护者是一个团队，并且使用一个共享的邮箱，则control文件中的Uploader字段应指定至少一个人的私人

20、邮箱地址；d）如果软件包不再使用或者不可维护，则应将软件包删除。9.2.8维护者脚本维护者脚本文件应以#!符号开头，这些脚本应是可读的、可被任何人执行的且不能是全局可写的。维护者脚本调用的程序不应在其前面添加路径，这些程序的路径应在PATH环境变量中。维护者脚本执行过程中，应符合以下要求：a）幂等性要求，一次或多次请求调用，确保不会因为崩溃而导致调用没有完成；b）如果维护者脚本与控制终端没有一起运行，则维护者脚本应回退到无交互行为状态；c）维护者脚本运行成功应返回0，运行失败应返回一个非零值；d）安装、升级和移除到新版本软件包中的脚本名称以new-开头，升级和移除的旧版本软件包中的脚本名称以o

21、ld-开头。9.3RPM包具体要求9.3.1版本号要求版本号的唯一性应适用于源码包和二进制包，在任何源码包下，二进制包不能重复使用。命名应符合Name-Version-Release.arch类型.rpm规范，Name为软件包名称，Version为软件版本号，Release为发布序列号。版本号一般有如下要求：a）仅当软件包比以前有较大改动时才增加Version号；b）软件开发者对软件包打补丁时应将Release号加1；c）不要在Source语句中包含任何路径。9.3.2SPEC文件SPEC文件应满足如下要求：a）使用UTF-8编码，各段落之间应空一行；b）文档开头以Summary开始，说明软件

22、包基本信息等内容；c）每个不同段落之间都以作为开头；d）包括Summary、Name、Version、Release、Vendor、Group,Source等必要信息。9.3.3包变更日志源码包的变更日志在changelog文件中加以说明，包括日期、维护者姓名、维护者联系方式、修改6DB43/T22592021的具体内容等。changelog文件的格式应符合以下要求：a）星期、月份均用英文形式的前3个字母，不应使用中文；b）每个changlog之间应有一空行。变更日志changelog文件格式应符合附录A的规定。9.3.4源码包构建原则源码包构建应遵循以下规则：a）只要存在spec文件，开发者

23、应在系统现有的spec文件上修改更新；b）任何人无权删除其他人的changelog和原始打包者的信息，但可追加自己的信息；c）spec文件应使用系统标准的宏定义；d）任何人都不应直接提供修改后的源代码，而应以补丁形式发布修改，在spec里完成打补丁操作，一个补丁只解决一个问题，任何补丁的授权方式应和被修改源代码保持一致。10桌面应用配置要求10.1desktop文件桌面应用开发应使用desktop文件，用于在开始菜单、办公桌面等启动应用，desktop文件应符合以下要求：a）应以应用安装后软件包管理工具可查询的软件名为desktop文件名，以.desktop为文件后缀；b）应符合Linux启动

24、器desktop文件编写格式，desktop文件格式示例见附录B；c）应用安装时，应将desktop文件放在“/usr/share/applications”目录下。10.2icon文件桌面应用开发应使用icon文件用于在开始菜单、任务栏等位置显示所需图标，icon文件应符合以下要求：a）icon文件名应为应用标识，图标文件格式为PNG/SVG，其中PNG图标大小要求128x128px及以上或全尺寸；b）icon若为PNG格式，在应用安装时应将icon文件放在“/usr/share/icons/hicolor”对应尺寸的目录下；c）icon若为SVG格式，在应用安装时应将icon文件放在“/u

25、sr/share/icons/hicolor/scalable/mimetypes/”目录下。10.3系统及应用服务要求系统及应用服务应符合以下要求：a）系统级服务应提供systemd的服务配置文件，并将其放在“/lib/systemd/system/”目录下；b）用户级服务应提供systemd的服务配置文件，并将其放在“/usr/lib/systemd/user/”目录下。11单进程要求11.1多用户单进程多用户单进程情况下，应用宜使用文件锁的形式实现单进程，文件锁放到“/run/”目录下，并使7DB43/T22592021用“应用名.pid”方式命名，文件锁内容为应用的进程号。11.2单用

26、户单进程单用户单进程情况下，应用宜使用文件锁的形式实现单进程，文件锁放到“/run/user/用户ID/”目录下，并使用“应用名.pid”方式命名，文件锁内容为应用的进程号。11.3特殊访问单进程特殊访问单进程情况下，应用宜使用文件锁的形式实现单进程，文件锁放到“/run/”目录或者“/run/user/用户ID/”目录下，并使用“应用名-特殊条件.pid”方式命名，文件锁内容为应用的进程号。12多进程要求12.1进程间通信要求进程间可使用信号、管道、套接字、消息队列、信号量、共享内存等方式实现通信。12.2系统资源限制要求系统在文件中设置默认的应用资源限制，每个进程都有一组资源限值。每个资源

27、都有软限制和硬限制2种关联限制，软限制规定了进程能够消耗的资源数量，进程可以将软限制设置为0到硬限制之间的值；硬限制为软限制设定上限，只有特权进程能够增大或者缩小硬限制。进程可使用getrlimit()函数读取自身的资源限制，可使用setrlimit()函数修改自身的资源限制。13兼容性要求除基础C库以外，应用不应依赖操作系统提供的任何动态链接库。应用不应直接修改操作系统提供的配置文件，宜通过操作系统提供的接口来修改，可以通过新增高优先级配置文件来进行配置覆盖，新增的配置文件以“两位数字-应用名.conf”的形式命名。8DB43/T22592021附录A（资料性）变更日志changelog文件

28、格式1、deb包变更日志changelog文件的格式定义如下：package(version）distribution(s);urgency=*changedetailsmorechangedetails*evenmorechangedetails-maintainernametwospacesdate其中，package(version)是安装包的名字和版本号；distribution(s)代表要发行的软件版本在上传时需要安装在哪里；urgency是为了表示这个版本比上一个版本的重要程度，它的选项有low,medium,high,emergency,critical；changedetail

29、s，至少要有2个空格开始，而且要以*号和分隔符一般是空格开始，下一行要和上一行对齐，建议这里不要写太多；maintainername，是安装包的维护人员的名字；Email，邮箱地址；Date，day-of-week,ddmonthyyyyhh:mm:ss+zzzz，其他的时间格式在本文件中不再介绍。2、变更细节changedetails可记录的选项包括：1）新增(Features)：新增功能；2）修复(Fixed)：修复bug；3）变更(Changed)：对某些已存在功能所发生的逻辑变化；4）优化(Refactored)：性能或结构上的优化，并带来功能的逻辑变化；5）即将删除(Deprecat