功能型模块编写教程

-这个教程将会教你编写功能型模块，但是你能不能学会就不关我事了.（手动滑稽）

基本介绍

  • 标准的功能型模块由一个文本文件直接翻译而成，需要一个!module作为头和尾。
  • 它将会被加载作为镧·系统工具箱中主要功能(处理器高级配置、io配置等）功能页面的内容

    模块的基本属性

  • 每一个功能型模块都需要定义class属性，定义方法为增加行class=xxx这个属性指定了该功能型模块将被防止到哪个页面。工具箱提供了以下可定义的接口。
  • cpua (处理器高级配置)
  • io (IO配置)
  • extra (杂项配置)
  • charge(充电控制)
  • selinux (SELinux页面配置）
  • 除此之外，模块可以在内部定义view属性，这将在模块内增加UI。

    view属性的定义

    1. !module
    2. class=xxx
    3. !view
    4. view=xxxx
    5. view属性的内容
    6. !view
    7. !module
  • 一个view属性代表一个UI组件。
  • 每一个view属性中，需要定义一个view子属性。如上示例所示。

  • 子属性的定义内容以及对应参数将在下方讲到。

    view的基本属性

    以下将module的view属性在UI上显示的效果简称为“组件”

    1. !module
    2. class=xxx
    3. !view
    4. view=xxxx
    6. root=true/false
    7. core=true/false
    9. @show
    10. #写一个shell脚本 返回true为显示组件 返回其他任何内容或不返回为不显示组件
    11. #以下是一个demo脚本 在/system/build.prop存在时返回true
    13. if [ -e /system/build.prop ]
    14. then
    15. echo true
    16. fi
    18. @show
    20. !view
    21. !module
  • 如上述示例所示 你可以通过格式整理来使模块更易阅读
  • root属性决定了这个组件的【任何】操作是否调用root权限
  • show属性决定了这个组件在什么情况下会显示【所有带shell在中间的属性全部用@xxx来定义】

  • core属性是一个【非常重要】的属性。

    1. 它是用来决定这个module的卡片是否显示用的。
    2. 假如一个模块中有一个带有core=true属性的组件处于显示状态（@show属性返回true)，
    3. 那么这个模块就会被显示，否则它将被隐藏。
    4. 即使一个模块中所有的组件的@show属性均返回true。但是如果所有的组件都没有core属性=true的定义，
    5. 那么这个模块也将不会被显示。
    6. 当然，它还决定了组件是否会被读取到【开机时应用】的任务列表中，非core=true的组件永远不会，也没有办法进入开机应用列表。

  • 引入看似混乱的core属性的作用在于。使模块中一些常显示的内容（如标题）不会影响模块的显示状态。

  • 以下这个例子能够让你更加清晰的认识core属性。
  1. !module
  2. //显示在杂项配置中
  3. class=extra
  4.   !view
  5.   //定义标题
  6.   view=title
  7.   text=一键变砖
  8.   @show
  9.   echo true
  10.   @show
  11.   !view
  13.   !view
  14.   view=subtitle
  15.   text=点击按钮一键变砖
  16.   @show
  17.   echo true
  18.   @show
  19.   !view
  21.   !view
  22.   //ui中加入的是按钮
  23.   view=button
  25.   root=true
  26.   core=true
  28.   @show
  29.   #写一个shell脚本 返回true为显示组件 返回其他任何内容或不返回为不显示组件
  30.   #以下是一个demo脚本 在/system/build.prop存在时返回true
  32.   if [ -e /system/build.prop ]
  33.   then
  34.   echo true
  35.   fi
  37.   @show
  39.   @click
  40.   #删除build.prop
  41.   rm -f /system/build.prop
  42.   @click
  44.   !view
  46. !module
  • 上面这个模块只会在build.prop存在时显示。准确的说，是button带领着整个模块显示的。（即使title和subtitle始终显示)

组件们

  • 以下内容将会介绍各种组件的用法

    title与subtitle

    1. !module
    2. class=xxx
    3. !view
    4. view=title/subtitle
    5. text=标题文字
    6. @show
    7. #return sth
    8. @show
    9. root=true/false
    10. core=true/false
    11. !view
    12. !module
  • 私有属性只有一个text，不多介绍

    switch开关

    1. !module
    2. class=xxx
    3. !view
    4. view=switch
    5. text=启用（emm想写什么都行）
    6. @show
    7. #return sth
    8. @show
    9. @click
    10. #此处提供变量$switch来显示当前switch状态
    11. if [ $switch == 1 ]
    12. then
    13. #显示toast弹窗
    14. echo @toast=开关是开启的
    15. else
    16. echo @toast=开关是关闭的
    17. fi
    18. @click
    19. @current
    20. #当前状态设置为打开状态
    21. echo true
    22. @current
    23. root=true/false
    24. core=true/false
    25. !view
    26. !module
  • 私有属性：click,current

    button按钮

    1. !module
    2. class=xxx
    3. !view
    4. view=button
    5. text=按钮文字
    6. @show
    7. #return sth
    8. @show
    9. @click
    10. $do sth
    11. @click
    12. root=true/false
    13. core=true/false
    14. !view
    15. !module
  • 很简单 click

    edittext文本编辑框

    1. !module
    2. class=xxx
    3. !view
    4. view=edittext
    5. text=文本框：
    6. @show
    7. #return sth
    8. @show
    9. @current
    10. echo 我是当前内容
    11. @current
    12. @done
    13. #提供变量$edittext
    14. echo @toast=你输入了$edittext
    15. @done
    16. width=200
    17. root=true/false
    18. core=true/false
    19. !view
    20. !module
  • done方法，代表在点击勾时的操作。
  • width属性。如果定义，则使用定义值作为输入框宽度。如果不定义，则使用默认值来作为宽度。（单位是dp，无需写上）

    spinner类似于处理器一般配置里的频率选择下拉菜单

    1. !module
    2. class=xxx
    3. !view
    4. view=spinner
    5. //定义条目
    6. item=我是第一条|我是第二条|我是第三条
    7. #也可以item_file=[path]这是从系统中读取，适用于末尾有空格的类似于处理器频率表文件的解析
    8. #也可以item_file_tcp=[path]这是从系统中读取，适用于末尾没空格的类似于处理器频率表文件的解析
    9. #也可以item_file_io=[path]这是从系统中读取，适用于类似于IO调度器的类似格式解析（有兴趣看看IO调度器的那个模块）
    10. text=选择一个条目：
    11. @show
    12. #return sth
    13. @show
    14. @current
    15. #默认选中第二个条目
    16. echo position=1
    17. #也可以echo label=条目的文字内容
    18. #也可以echo io_label=`cat [path]` 方便类IO调度器状态的解析
    19. @current
    20. @done
    21. #提供变量$label与$position
    22. echo @toast=当前点击了第$position个条目（从0开始算），条目的内容是$label
    23. @done
    24. root=true/false
    25. core=true/false
    26. !view
    27. !module
  • done属性与current属性提供多变量。

    seekbar 拖动条

  • 直接贴出高通Gpu调度激进程度控制来进行解读 
    2. !module
    3. class=cpua
    4. !view
    5. view=title
    6. text=高通GPU调度配置
    7. @show
    8. echo true
    9. @show
    10. !view

!view view=subtitle text=调整高通GPU调度的激进程度 @show echo true @show !view

!view view=seekbar //\s可以用来表示空格 你也可以直接打空格 text=《——保守\s\s\s\s\s\s\s\s\s\s\s\s\s\s\s\s\s激进——》 @max

返回一个数字作为这个进度条的最大值

cat /sys/class/kgsl/kgsl-3d0/min_pwrlevel @max @show

在需要时显示

if [ -e /sys/class/kgsl/kgsl-3d0/default_pwrlevel ] then echo true fi @show @current

当前状态

这里牵扯到一个小算法 因为gpu调度激进程度和数字时相反的。数字越大反而越不激进。因此我们需要将它倒回来。

r=cat /sys/class/kgsl/kgsl-3d0/default_pwrlevel let c=max-r echo $c @current

@done

我们提供了$max和$seekbar两个变量，分别代表最大值和当前值，方便计算。

下列算法又需要将它倒回来

此处千万不能去掉调用前的$ 即使它在bash下可以被去掉

let r=$max-$seekbar echo $r > /sys/class/kgsl/kgsl-3d0/default_pwrlevel @done core=true root=true !view !module

  • 这个组件不算难 没什么可多讲的。
  • 还有一个text组件，拥有属性@text。作用是动态显示text。其它与title以及subtitle完全相同。

    假如你有不清楚的地方，可以去官方模块仓库一探究竟。