xref: /foundation/arkui/ace_engine/OAT.xml

<?xml version="1.0" encoding="UTF-8"?>
<!-- Copyright (c) 2021 Huawei Device Co., Ltd.

     Licensed under the Apache License, Version 2.0 (the "License");
     you may not use this file except in compliance with the License.
     You may obtain a copy of the License at

          http://www.apache.org/licenses/LICENSE-2.0

     Unless required by applicable law or agreed to in writing, software
     distributed under the License is distributed on an "AS IS" BASIS,
     WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
     See the License for the specific language governing permissions and
     limitations under the License.
-->
<!-- OAT(OSS Audit Tool) configuration guide:
basedir: Root dir, the basedir + project path is the real source file location.
licensefile:
1.If the project don't have "LICENSE" in root dir, please define all the license files in this project in , OAT will check license files according to this rule.

tasklist(only for batch mode):
1. task: Define oat check thread, each task will start a new thread.
2. task name: Only an name, no practical effect.
3. task policy: Default policy for projects under this task, this field is required and the specified policy must defined in policylist.
4. task filter: Default filefilter for projects under this task, this field is required and the specified filefilter must defined in filefilterlist.
5. task project: Projects to be checked, the path field define the source root dir of the project.


policyList:
1. policy: All policyitems will be merged to default OAT.xml rules, the name of policy doesn't affect OAT check process.
2. policyitem: The fields type, name, path, desc is required, and the fields rule, group, filefilter is optional,the default value is:
<policyitem type="" name="" path="" desc="" rule="may" group="defaultGroup" filefilter="defaultPolicyFilter"/>
3. policyitem type:
    "compatibility" is used to check license compatibility in the specified path;
    "license" is used to check source license header in the specified path;
    "copyright" is used to check source copyright header in the specified path;
    "import" is used to check source dependency in the specified path, such as import ... ,include ...
    "filetype" is used to check file type in the specified path, supported file types: archive, binary
    "filename" is used to check whether the specified file exists in the specified path(support projectroot in default OAT.xml), supported file names: LICENSE, README, README.OpenSource

4. policyitem name: This field is used for define the license, copyright, "*" means match all, the "!" prefix means could not match this value. For example, "!GPL" means can not use GPL license.
5. policyitem path: This field is used for define the source file scope to apply this policyitem, the "!" prefix means exclude the files. For example, "!.*/lib/.*" means files in lib dir will be exclude while process this policyitem.
6. policyitem rule and group: These two fields are used together to merge policy results. "may" policyitems in the same group means any one in this group passed, the result will be passed.
7. policyitem filefilter: Used to bind filefilter which define filter rules.
8. filefilter: Filter rules, the type filename is used to filter file name, the type filepath is used to filter file path.

Note:If the text contains special characters, please escape them according to the following rules:
" == &gt;
& == &gt;
' == &gt;
< == &gt;
> == &gt;
-->
<configuration>
    <oatconfig>
        <licensefile></licensefile>
        <policylist>
            <policy name="projectPolicy" desc="">
                <policyitem type="license" name="BSD-3-Clause" path="frameworks/core/pipeline/LICENSE" desc="三方软件许可证， 与Apache兼容"/>
                <policyitem type="copyright" name="Shenzhen Kaihong Digital Industry Development Co., Ltd." path=".*" rule="may" group="defaultGroup" filefilter="copyrightPolicyFilter" desc="Developed By Kaihong"/>
                <policyitem type="copyright" name="iSoftStone Information Technology (Group) Co.,Ltd." path=".*" desc=""/>
            </policy>
        </policylist>
        <filefilterlist>
            <filefilter name="binaryFileTypePolicyFilter" desc="二进制文件校验策略的过滤条件" >
                <filteritem type="filepath" name="frameworks/base/resource/binary/mac/.*.o" desc="来源于代码仓foundation/arkui/ace_engine/frameworks/base/resource/binary下的svg编译而来。现有的objcopy工具链在mac上不能用，使用开源工具转换成.o。"/>
                <filteritem type="filepath" name="frameworks/base/network/cacert.pem" desc="三方库libcurl使用的公钥证书文件，curl官网下载得到。"/>
            </filefilter>
            <filefilter name="binaryFileTypePolicyFilter" desc="二进制文件校验策略的过滤条件" >
                <filteritem type="filepath" name="test/resource/graphicalbasicability/imageprovider/images/broken.bmp" desc="自造的二进制图片"/>
                <filteritem type="filepath" name="test/resource/graphicalbasicability/imageprovider/images/broken.webp" desc="自造的二进制图片"/>
                <filteritem type="filepath" name="test/resource/graphicalbasicability/imageprovider/images/unbroken.bmp" desc="自研图片"/>
                <filteritem type="filepath" name="test/resource/graphicalbasicability/imageprovider/images/unbroken.webp" desc="自研图片"/>
                <filteritem type="filepath" name="test/resource/graphicalbasicability/imageprovider/images/unbroken.gif" desc="自研的二进制图片"/>
                <filteritem type="filepath" name="test/resource/graphicalbasicability/imageprovider/images/unbroken.jpg" desc="自研的二进制图片"/>
                <filteritem type="filepath" name="test/resource/graphicalbasicability/imageprovider/images/unbroken.png" desc="自研的二进制图片"/>
                <filteritem type="filepath" name="test/resource/graphicalbasicability/imageprovider/images/broken.gif" desc="自研的二进制图片"/>
                <filteritem type="filepath" name="test/resource/graphicalbasicability/imageprovider/images/broken.jpg" desc="自研的二进制图片"/>
                <filteritem type="filepath" name="test/resource/graphicalbasicability/imageprovider/images/broken.png" desc="自研的二进制图片"/>
                <filteritem type="filepath" name="frameworks/base/resource/binary/rate_star_big_off.png" desc="自研的二进制图片"/>
                <filteritem type="filepath" name="frameworks/base/resource/binary/rate_star_big_on.png" desc="自研的二进制图片"/>
                <filteritem type="filepath" name="frameworks/base/resource/binary/rate_star_big_half.png" desc="自研的二进制图片"/>
                <filteritem type="filepath" name="frameworks/base/resource/binary/rate_star_small_off.png" desc="自研的二进制图片"/>
                <filteritem type="filepath" name="frameworks/base/resource/binary/rate_star_small_on.png" desc="自研的二进制图片"/>
                <filteritem type="filepath" name="frameworks/base/resource/binary/rate_star_small_half.png" desc="自研的二进制图片"/>
                <filteritem type="filepath" name="frameworks/base/resource/binary/select_arrow_disabled.png" desc="自研的二进制图片"/>
                <filteritem type="filepath" name="frameworks/base/resource/binary/select_arrow_normal.png" desc="自研的二进制图片"/>
                <filteritem type="filepath" name="frameworks/base/resource/binary/tv_rate_star_big_half.png" desc="自研的二进制图片"/>
                <filteritem type="filepath" name="frameworks/base/resource/binary/tv_rate_star_big_off.png" desc="自研的二进制图片"/>
                <filteritem type="filepath" name="frameworks/base/resource/binary/tv_rate_star_big_on.png" desc="自研的二进制图片"/>
                <filteritem type="filepath" name="frameworks/base/resource/binary/tv_rate_star_small_half.png" desc="自研的二进制图片"/>
                <filteritem type="filepath" name="frameworks/base/resource/binary/tv_rate_star_small_off.png" desc="自研的二进制图片"/>
                <filteritem type="filepath" name="frameworks/base/resource/binary/tv_rate_star_small_on.png" desc="自研的二进制图片"/>
                <filteritem type="filepath" name="frameworks/base/resource/binary/indexer_arrow.png" desc="自研的二进制图片"/>
                <filteritem type="filepath" name="frameworks/base/resource/binary/navigation_bar_back.png" desc="自研的二进制图片"/>
                <filteritem type="filepath" name="frameworks/base/resource/binary/navigation_bar_more.png" desc="自研的二进制图片"/>
                <filteritem type="filepath" name="figures/JS-UI框架架构.png" desc="自研的二进制图片"/>
                <filteritem type="filepath" name="figures/framework-architecture.png" desc="自研的二进制图片"/>
                <filteritem type="filepath" name="frameworks/base/resource/binary/fa_black_clock_widget_hour.png" desc="自研的二进制图片"/>
                <filteritem type="filepath" name="frameworks/base/resource/binary/fa_black_clock_widget_minute.png" desc="自研的二进制图片"/>
                <filteritem type="filepath" name="frameworks/base/resource/binary/fa_black_clock_widget_second.png" desc="自研的二进制图片"/>
                <filteritem type="filepath" name="frameworks/base/resource/binary/fa_clock_widget_hour.png" desc="自研的二进制图片"/>
                <filteritem type="filepath" name="frameworks/base/resource/binary/fa_clock_widget_minute.png" desc="自研的二进制图片"/>
                <filteritem type="filepath" name="frameworks/base/resource/binary/fa_clock_widget_second.png" desc="自研的二进制图片"/>
                <filteritem type="filepath" name="examples/components/entry/src/main/resources/base/media/startIcon.png" desc="检视应用工程自带的二进制图片"/>
                <filteritem type="filepath" name="examples/components/entry/src/main/resources/base/media/foreground.png" desc="检视应用工程自带的二进制图片"/>
                <filteritem type="filepath" name="examples/components/entry/src/main/resources/base/media/background.png" desc="检视应用工程自带的二进制图片"/>
                <filteritem type="filepath" name="examples/components/feature/src/main/resources/base/media/foreground.png" desc="检视应用工程自带的二进制图片"/>
                <filteritem type="filepath" name="examples/components/feature/src/main/resources/base/media/startIcon.png" desc="检视应用工程自带的二进制图片"/>
                <filteritem type="filepath" name="examples/components/feature/src/main/resources/base/media/background.png" desc="检视应用工程自带的二进制图片"/>
				<filteritem type="filepath" name="test/component_test/test_cases/components/.*/entry/src/main/resources/base/media/startIcon.png" desc=" 测试工程自带的二进制图片"/>
				<filteritem type="filepath" name="test/component_test/test_cases/components/.*/entry/src/main/resources/rawfile/TESTFONT.TTF" desc="用于测试的假字体文件，是空文本文件"/>
				<filteritem type="filepath" name="test/component_test/test_cases/components/navigation/entry/src/main/resources/base/media/test_image.png" desc=" 自研的二进制图片"/>
				<filteritem type="filepath" name="test/component_test/test_cases/components/navigation/entry/src/main/resources/base/media/Tab.jpg" desc=" 自研的二进制图片"/>
				<filteritem type="filepath" name="test/component_test/test_cases/components/miscellaneous/entry/src/main/resources/base/media/foreground.png" desc=" 自研的二进制图片"/>
				<filteritem type="filepath" name="test/component_test/test_cases/components/miscellaneous/entry/src/main/resources/base/media/background.png" desc=" 自研的二进制图片"/>
				<filteritem type="filepath" name="test/component_test/test_cases/components/image_video_and_media/entry/src/main/ets/pages/image/image_one.png" desc=" 自研的二进制图片"/>
				<filteritem type="filepath" name="test/component_test/test_cases/components/image_video_and_media/entry/src/main/ets/pages/image/image_two.png" desc=" 自研的二进制图片"/>
				<filteritem type="filepath" name="test/component_test/test_cases/components/image_video_and_media/entry/src/main/ets/pages/image_animator/imageAnimator_one.png" desc=" 自研的二进制图片"/>
				<filteritem type="filepath" name="test/component_test/test_cases/components/image_video_and_media/entry/src/main/resources/base/media/test_image.png" desc=" 自研的二进制图片"/>
				<filteritem type="filepath" name="test/component_test/test_cases/components/image_video_and_media/entry/src/main/resources/base/media/test_icon.png" desc=" 自研的二进制图片"/>
				<filteritem type="filepath" name="test/component_test/test_cases/components/image_video_and_media/entry/src/main/resources/base/media/run_icon.png" desc=" 自研的二进制图片"/>
				<filteritem type="filepath" name="test/component_test/test_cases/components/image_video_and_media/entry/src/main/resources/base/media/city_icon.png" desc=" 自研的二进制图片"/>
				<filteritem type="filepath" name="test/component_test/test_cases/components/graphic_drawing/entry/src/main/ets/pages/image_bitmap/image.jpg" desc=" 自研的二进制图片"/>
				<filteritem type="filepath" name="test/component_test/test_cases/components/image_video_and_media/entry/src/main/resources/rawfile/video1.mp4" desc=" 自研的二进制视频"/>
				<filteritem type="filepath" name="test/component_test/test_cases/components/image_video_and_media/entry/src/main/resources/rawfile/video2.mp4" desc=" 自研的二进制视频"/>
				<filteritem type="filepath" name="test/component_test/test_cases/components/button_and_selection/entry/src/main/ets/pages/slider/StarYellow.png" desc=" 自研的二进制图片"/>
				<filteritem type="filepath" name="test/component_test/test_cases/components/button_and_selection/entry/src/main/ets/pages/rating/StarBlue.png" desc=" 自研的二进制图片"/>
				<filteritem type="filepath" name="test/component_test/test_cases/components/button_and_selection/entry/src/main/ets/pages/rating/StarOrange.png" desc=" 自研的二进制图片"/>
				<filteritem type="filepath" name="test/component_test/test_cases/components/button_and_selection/entry/src/main/resources/base/media/foreground.png" desc=" 自研的二进制图片"/>
				<filteritem type="filepath" name="test/component_test/test_cases/components/button_and_selection/entry/src/main/resources/base/media/background.png" desc=" 自研的二进制图片"/>
            </filefilter>
            <filefilter name="copyrightPolicyFilter" desc="copyright文件头校验策略的过滤条件" >
                <filteritem type="filepath" name="frameworks/core/components/theme/theme.csv" desc="csv无法添加版权头"/>
                <filteritem type="filepath" name="frameworks/bridge/declarative_frontend/state_mgmt/parser.pegjs" desc="用于测试的文件无法添加License"/>
                <filteritem type="filepath" name="frameworks/bridge/declarative_frontend/state_mgmt/src/utest/resources/test.db" desc="用于测试的文件无法添加License"/>
                <filteritem type="filepath" name="frameworks/bridge/declarative_frontend/state_mgmt_pu/src/utest/resources/test.db" desc="用于测试的文件无法添加License"/>
                <filteritem type="filepath" name="test/resource/graphicalbasicability/imagecache/images/1008157312073340586" desc="自造的二进制文件无法添加版权头"/>
                <filteritem type="filepath" name="test/resource/graphicalbasicability/imagecache/images/13610839755484614436" desc="自造的二进制文件无法添加版权头"/>
                <filteritem type="filepath" name="test/resource/graphicalbasicability/imagecache/images/5841967474238710136" desc="自造的二进制文件无法添加版权头"/>
                <filteritem type="filepath" name="test/resource/graphicalbasicability/imagecache/images/748621363886323660" desc="自造的二进制文件无法添加版权头"/>
                <filteritem type="filepath" name="test/resource/graphicalbasicability/imagecache/images/8819493328252140263" desc="自造的二进制文件无法添加版权头"/>
                <filteritem type="filepath" name="examples/components/hvigor/hvigor-wrapper.js" desc="检视应用工程工具链文件无法添加版权头"/>
            </filefilter>
            <filefilter name="defaultPolicyFilter" desc="根目录LICENSE文件校验策略的过滤条件xxx" >
                <filteritem type="filepath" name="frameworks/core/components/theme/theme.csv" desc="csv无法添加License"/>
                <filteritem type="filepath" name="frameworks/bridge/declarative_frontend/state_mgmt/parser.pegjs" desc="用于测试的文件无法添加License"/>
                <filteritem type="filepath" name="frameworks/bridge/declarative_frontend/state_mgmt/src/utest/resources/test.db" desc="用于测试的文件无法添加License"/>
                <filteritem type="filepath" name="frameworks/bridge/declarative_frontend/state_mgmt_pu/src/utest/resources/test.db" desc="用于测试的文件无法添加License"/>
                <filteritem type="filepath" name="test/resource/graphicalbasicability/imagecache/images/1008157312073340586" desc="用于测试自造的二进制文件无法添加License"/>
                <filteritem type="filepath" name="test/resource/graphicalbasicability/imagecache/images/13610839755484614436" desc="用于测试自造的二进制文件无法添加License"/>
                <filteritem type="filepath" name="test/resource/graphicalbasicability/imagecache/images/5841967474238710136" desc="用于测试自造的二进制文件无法添加License"/>
                <filteritem type="filepath" name="test/resource/graphicalbasicability/imagecache/images/748621363886323660" desc="用于测试自造的二进制文件无法添加License"/>
                <filteritem type="filepath" name="test/resource/graphicalbasicability/imagecache/images/8819493328252140263" desc="用于测试自造的二进制文件无法添加License"/>
                <filteritem type="filepath" name="examples/components/hvigor/hvigor-wrapper.js" desc="检视应用工程工具链文件无法添加License"/>
            </filefilter>
        </filefilterlist>

    </oatconfig>
</configuration>