SystemProperties

一 ： 

SystemProperties系统属性，对整个系统全局共享，通过SystemProperties.set()/SystemProperties.get()这两个函数对系统的属性进行读取和设置。

可以通过ADB shell进行查看，具体方法是adb shell getprop +“具体的属性对应的名称”就可以读取你想要的属性了。如果不知道具体的属性是什么名称也可以先输入adb shell getprop命令回车，就会显示出所有手机所支持的属性名称及对应的值。


主要属性如下（参考机为联想P780海外版本）：


（1）gsm开头的是移动电话的一些版本信息（软硬件，基带版本等信息）、所在国家、漫游状态、序列号等信息等一系列与sim相关的信息


（2）ro开头的是只读属性，一旦赋值不能修改


（3）sys开头的是系统信息


（4）persist和ril开头的不知道啥意思


（5）init.svc手机当前进程的状态（启动的显示running未启动的显示stopped）。进程是否启动是有init.rc文件中定义的


（6）net开头的是与网络相关的信息，比如dns、主机名、为各功能预留的缓冲区大小


（7）dhcp.wlan 是网关、IP地址等无线网络相关信息；


（8）external_sd_path 是外部存储SD卡的路径


（9）fmradio.driver 是FMradio相关属性


（10）其他的信息

二：

Android 的系统属性包括两部分：文件保存的持久属性和每次开机导入的cache属性。前者主要保存在下面几个文件中：


bionic/libc/include/sys/_system_properties.h


1     #define PROP_SERVICE_NAME "property_service"
2     #define PROP_PATH_RAMDISK_DEFAULT  "/default.prop"
3     #define PROP_PATH_SYSTEM_BUILD     "/system/build.prop"
4     #define PROP_PATH_SYSTEM_DEFAULT   "/system/default.prop"
5     #define PROP_PATH_LOCAL_OVERRIDE   "/data/local.prop"


后者则通过frameworks/base/core/java/android/os/SystemProperties.java的接口定义，




 1     private static native String native_get(String key);
 2     private static native String native_get(String key, String def);
 3     private static native void native_set(String key, String def);
 4     public static void set(String key, String val) {
 5         if (key.length() > PROP_NAME_MAX) {
 6             throw new IllegalArgumentException("key.length > " + PROP_NAME_MAX);
 7         }
 8         if (val != null && val.length() > PROP_VALUE_MAX) {
 9             throw new IllegalArgumentException("val.length > " +
10                 PROP_VALUE_MAX);
11         }
12         native_set(key, val);
13     }


该接口类在初始化运行环境中注册对应的cpp接口android_os_SystemProperties.cpp，实际操作通过JNI调用的是cpp文件对应的接口：


frameworks/base/core/jni/AndroidRuntime.cpp


1     namespace android {
2     extern int register_android_os_SystemProperties(JNIEnv *env);
3     }


frameworks/base/core/jni/android_os_SystemProperties.cpp


 1     static void SystemProperties_set(JNIEnv *env, jobject clazz, jstring keyJ, jstring valJ)
 2     {
 3         int err;
 4         const char* key;
 5         const char* val;
 6         key = env->GetStringUTFChars(keyJ, NULL);
 7         if (valJ == NULL) {
 8             val = "";       /* NULL pointer not allowed here */
 9         } else {
10             val = env->GetStringUTFChars(valJ, NULL);
11         }
12         err = property_set(key, val);
13         env->ReleaseStringUTFChars(keyJ, key);        
14         if (valJ != NULL) {
15             env->ReleaseStringUTFChars(valJ, val);
16         }
17     }


设置key的value时，需要作鉴权，根据设置程序所在进程的fd获知uid值，比如system server进程可以设置net打头的key，不可以设置gsm打头的key，相关的定义如下：


system/core/include/private/android_filesystem_config.h


1     #define AID_ROOT             0  /* traditional unix root user */
2     #define AID_SYSTEM        1000  /* system server */
3     #define AID_RADIO         1001  /* telephony subsystem, RIL */
4     #define AID_DHCP          1014  /* dhcp client */
5     #define AID_SHELL         2000  /* adb and debug shell user */
6     #define AID_CACHE         2001  /* cache access */
7     #define AID_APP          10000 /* first app user */


system/core/init/property_service.c


 1     #define PERSISTENT_PROPERTY_DIR  "/data/property"
 2     struct {
 3         const char *prefix;
 4         unsigned int uid;
 5     } property_perms[] = {
 6         { "net.rmnet0.",    AID_RADIO },
 7         { "net.gprs.",      AID_RADIO },
 8         { "ril.",           AID_RADIO },
 9         { "gsm.",           AID_RADIO },
10         { "net.dns",        AID_RADIO },
11         { "net.usb0",       AID_RADIO },
12         { "net.",           AID_SYSTEM },
13         { "dev.",           AID_SYSTEM },
14         { "runtime.",       AID_SYSTEM },
15         { "hw.",            AID_SYSTEM },
16         { "sys.",        AID_SYSTEM },
17         { "service.",    AID_SYSTEM },
18         { "wlan.",        AID_SYSTEM },
19         { "dhcp.",        AID_SYSTEM },
20         { "dhcp.",        AID_DHCP },
21         { "debug.",        AID_SHELL },
22         { "log.",        AID_SHELL },
23         { "service.adb.root",    AID_SHELL },
24         { "persist.sys.",    AID_SYSTEM },
25         { "persist.service.",   AID_SYSTEM },
26         { NULL, 0 }
27     };
28     int property_set(const char *name, const char *value)
29     {
30         property_changed(name, value);
31         return 0;
32     }
33     int start_property_service(void)
34     {
35         int fd;
36 
37         load_properties_from_file(PROP_PATH_SYSTEM_BUILD);
38         load_properties_from_file(PROP_PATH_SYSTEM_DEFAULT);
39         load_properties_from_file(PROP_PATH_LOCAL_OVERRIDE);
40         /* Read persistent properties after all default values have been loaded. */
41         load_persistent_properties();
42 
43         fd = create_socket(PROP_SERVICE_NAME, SOCK_STREAM, 0666, 0, 0);
44         if(fd < 0) return -1;
45         fcntl(fd, F_SETFD, FD_CLOEXEC);
46         fcntl(fd, F_SETFL, O_NONBLOCK);
47 
48         listen(fd, 8);
49         return fd;
50     }
51     void handle_property_set_fd(int fd)
52     {
53         switch(msg.cmd) {
54         case PROP_MSG_SETPROP:
55             msg.name[PROP_NAME_MAX-1] = 0;
56             msg.value[PROP_VALUE_MAX-1] = 0;
57 
58             if(memcmp(msg.name,"ctl.",4) == 0) {
59                 if (check_control_perms(msg.value, cr.uid)) {
60                     handle_control_message((char*) msg.name + 4, (char*) msg.value);
61                 } else {
62                     ERROR("sys_prop: Unable to %s service ctl [%s] uid: %d pid:%d\n",
63                             msg.name + 4, msg.value, cr.uid, cr.pid);
64                 }
65             } else {
66                 if (check_perms(msg.name, cr.uid)) {
67                     property_set((char*) msg.name, (char*) msg.value);
68                 } else {
69                     ERROR("sys_prop: permission denied uid:%d  name:%s\n",
70                           cr.uid, msg.name);
71                 }
72             }
73             break;
74 
75         default:
76             break;
77         }
78     }


在开机启动后的init操作中，会执行一个loop循环，当检测到有新的设置时，进入设置流程，鉴权失败会提示相关的异常，如sys_prop: permission denied uid:1000  name:gsm.phone.id


system/core/init/init.c


 1     void property_changed(const char *name, const char *value)
 2     {
 3         if (property_triggers_enabled) {
 4             queue_property_triggers(name, value);
 5             drain_action_queue();
 6         }
 7     }
 8     int main(int argc, char **argv)
 9     {
10         parse_config_file("/init.rc");
11         qemu_init();
12         device_fd = device_init();
13         property_init();
14         fd = open(console_name, O_RDWR);
15         property_set_fd = start_property_service();
16         ufds[0].fd = device_fd;
17         ufds[0].events = POLLIN;
18         ufds[1].fd = property_set_fd;
19         ufds[1].events = POLLIN;
20         ufds[2].fd = signal_recv_fd;
21         ufds[2].events = POLLIN;
22         fd_count = 3;
23         for(;;) {
24             if (ufds[0].revents == POLLIN)
25                 handle_device_fd(device_fd);
26 
27             if (ufds[1].revents == POLLIN)
28                 handle_property_set_fd(property_set_fd);
29             if (ufds[3].revents == POLLIN)
30                 handle_keychord(keychord_fd);
31         }
32         return 0;
33     }



3.Android属性系统

介绍了Android中三种方式来设置和获取属性。


Native代码中通过property_get/property_set来读取和设置属性。


属性（property）系统对Android来说是一个重要的功能。他作为一个系统服务管理着系统的配置和状态，所有的这些系统配置和状态都是属性（property）。属性（property）是一对键/值（key/value）组合，键和值都是字符串类型。总体感觉属性系统非常像Windows的注册表的功能。Androd中非常多的应用程序和库直接或者间接的依赖于属性系统，并由此决定其运行期的行为。例如：adbd进程通过属性来决定是否当前运行在模拟器中。再比如：java.io.File.pathSeparator方法返回存储在属性服务中的值。


属性系统怎样工作


    属性系统宏观的结构图如下所示：


    从图中我们可以看出Android属性系统由有三个进程，一组属性文件和一块共享内存组成。这块共享内存保存着系统中所有的属性记录，只有Property service能写这块共享内存，并且Property service负责将属性文件中的属性记录加载到共享内存中。


    属性读取进程（property consumer）把这块共享内存映射到自己的进程空间，然后直接读取它。属性设置进程（property setter）也加载这块共享到他的进程空间，但是他不能直接写这块共享内存。当他需要增加或者修改属性的时候，通过Unix Socket发生属性给Property service，Property service将代表设置进程写入共享内存和属性文件。


    Property service运行于init进程中。init进程首先创建一块共享内存，并把他的句柄fd存放在这块内存中，init进程通过mmap带MAP_SHARE标志的系统调用，把这块内存映射到他的虚拟空间中，最终这块内存所有的更新将会被所有映射这块共享内存的进程看到。共享内存句柄fd和共享内存大小存储在系统环境变量“ANDROID_PROPERTY_WORKSPACE”中，所有的进程包括属性设置进程和属性读取进程都将通过这个系统环境变量获得共享内存的句柄fd和大小，然后把这块内存映射到他们自己的虚拟空间。共享内存布局如下：


    然后，init进程将会从以下文件中加载属性：


   1: /default.prop
   2: /system/build.prop
   3: /system/default.prop
   4: /data/local.prop
    下一步是启动Property service。这步中，将会创建一个Unix Socket服务器，这个Socket有一个闻名的名称“/dev/socket/property_service”。最后init进入死循环，等待socket的连接请求。


    在读取进程中，当它初始化libc库的时候，将会获得属性系统共享内存的句柄和大小（bionic/libc/bionic/libc_init_common.c __libc_init_common函数）。并把这块共享内存映射到自己的进程虚拟空间中(bionic/libc/bionic/system_properties.c __system_properties_init函数)。这样读取进程将会向访问普通内存一样访问属性系统的共享内存了。


    当前，属性不能被删除。也就是说一旦属性被创建，将不可以被删除，但是它们可以被修改。


怎样获得和设置属性


    在Android中有三种方式来设置和获取属性：


1、Native代码


    当编写Native的程序时，可以使用property_get和property_set API来获得和设置属性。使用这两个API必须要包含头文件cutils/properties.h和链接libcutil库。


2、Java代码


    Android在Java库中提供System.getProperty和System.setProperty方法，我们Java程序可以通过他们来设置和获得属性。


    但是请注意！虽然从语法上面看Java的代码和Native代码非常相近，但是Java版本存储把属性存在其他地方，而不是我们上面提到的属性系统中。在JVM中有一个hash表来维护Java的属性。所以Java属性和Android属性是不同的，不能用Java API（System.getProperty和System.setProperty）来设置系统属性。也不能通过Native的方法（property_get和property_set）设置Java的属性。


更新：Andrew指出android.os.SystemProperties可以操作Android系统属性（虽然这个类倾向于内部使用）。这个类通过JNI调用Native的property_get和property_set方法来获得和设置属性。


3、Shell脚本


   Android提供了命令行工具setprop和getprop来设置和获取属性，他们可以在脚本中被使用。


         补充：通过查看property_service.c，我们可以明确以下事实：

1、  属性名不是随意取的。在property_perms数组中定义了当前系统上可用的所有属性的前缀，以及相对应的存取权限UID。对属性的设置要满足权限要求，同时命名也要在这些定义的范围内。


2、  PA_COUNT_MAX指定了系统（共享内存区域中）最多能存储多少个属性。


3、  PROP_NAME_MAX指定了一个属性的key最大允许长度；PROP_VALUE_MAX则指定了value的最大允许长度。

此外，http://blog.csdn.net/tekkamanitachi/archive/2009/06/18/4280982.aspx 这篇文章翻译了Android的官方文档，从另一个角度叙述了属性系统，需要者请参看。

property_get/property_set

http://blog.csdn.net/xujianqun/article/details/6363318

每个属性都有一个名称和值，他们都是字符串格式。属性被大量使用在Android系统中，用来记录系统设置或进程之间的信息交换。属性是在整个系统中全局可见的。每个进程可以get/set属性。

在系统初始化时，Android将分配一个共享内存区来存储的属性。这些是由“init”守护进程完成的，其源代码位于：device/system/init。“init”守护进程将启动一个属性服务。

属性服务在“init”守护进程中运行。每一个客户端想要设置属性时，必须连接属性服务，再向其发送信息。属性服务将会在共享内存区中修改和创建属性。任何客户端想获得属性信息，可以从共享内存直接读取。这提高了读取性能。 客户端应用程序可以调用libcutils中的API函数以GET/SET属性信息。libcutils的源代码位于：device/libs/cutils。API函数是：


int property_get(const char *key, char *value, const char *default_value);


int property_set(const char *key, const char *value);


而libcutils又调用libc中的 __system_property_xxx 函数获得共享内存中的属性。libc的源代码位于：device/system/bionic。

属性服务调用libc中的__system_property_init函数来初始化属性系统的共享内存。当启动属性服务时，将从以下文件中加载默认属性：

/default.prop


/system/build.prop


/system/default.prop


/data/local.prop

属性将会以上述顺序加载。后加载的属性将覆盖原先的值。这些属性加载之后，最后加载的属性会被保持在/data/property中。


特别属性 如果属性名称以“ro.”开头，那么这个属性被视为只读属性。一旦设置，属性值不能改变。


如果属性名称以“persist.”开头，当设置这个属性时，其值也将写入/data/property。


如果属性名称以“net.”开头，当设置这个属性时，“net.change”属性将会自动设置，以加入到最后修改的属性名。（这是很巧妙的。 netresolve模块的使用这个属性来追踪在net.*属性上的任何变化。）

属性“ ctrl.start ”和“ ctrl.stop ”是用来启动和停止服务。

每一项服务必须在/init.rc中定义.系统启动时，与init守护进程将解析init.rc和启动属性服务。一旦收到设置“ ctrl.start ”属性的请求，属性服务将使用该属性值作为服务名找到该服务，启动该服务。这项服务的启动结果将会放入“ init.svc.<服务名>“属性中 。客户端应用程序可以轮询那个属性值，以确定结果。

三：

查看系统属性build.prop
　　　Android系统主要通过SystemProperties这个类，直接本地调用来实现创建、获取及修改系统属性。
　　　Systemproperties类在android.os下，路径为：
　　　/frameworks/base/core/java/android/os/SystemProperties.java
　　　
　　　在手机系统中，我们可以通过如下命令查看到系统属性文件build.prop。
　　　jinzhimin@jinzhimin:~$ adb remount        //连接到手机系统
　　　remount succeeded
　　　jinzhimin@jinzhimin:~$ adb shell           //进入到手机系统
　　　# cd system                              //连接system目录
　　　# ls                                     //查看文件
　　　usr
　　　xbin
　　　bin
　　　res
　　　media
　　　lib
　　　vendor
　　　etc
　　　app
　　　build.prop
　　　fonts
　　　secro
　　　lost+found
　　　framework
　　　# exit                                   //退出手机系统
jinzhimin@jinzhimin:~$ adb pull /system/build.prop /home/jinzhimin/00          //将系统属性文件build.prop拷贝出来
　　　43 KB/s (3543 bytes in 0.079s)
　　　jinzhimin@jinzhimin:~$
　　　
　　　这样，我们就可以通过build.prop查看手机系统属性了。
　　　当然了，我们在成功编译完源代码后，在以下目录下也可以看到build.prop。
　　　/out/target/product/huaqin75_cu_ics/system/build.prop
　　　
　　　build.prop是如何生成的呢？Android的build.prop文件是在Android编译时刻收集的各种property，编译完成之后，文件生成在/out/target/product/huaqin75_cu_ics/system/目录下。在Android运行时刻可以通过SystemProperties_get*()读取这些属性值。
　　　build.prop的生成是由make系统解析build/core/Makefile完成。
二、Android手机build.prop参数详解（手机型号不同，有些内容可能不一样）
　　ro.build.version.sdk=10         sdk版本 10对应2.3ROM
　　ro.build.version.release=2.3.4    android版本
　　ro.build.date=三 12月 15 20:41:26 CST 2010   时区时间CST可以代表4个时区
　　ro.product.model=GT540           手机型号    
　　ro.product.locale.language=zh   刷机后默认语言
　　ro.product.locale.region=CN     刷机后启动的默认语言
　　ro.build.description=soju-user 2.3.3 GRI40 102588 release-keys    内部版本号
　　Default network type.   # 0 => WCDMA preferred.         默认网络类型
　　wifi.supplicant_scan_interval=120    WIFI扫描时间单位为秒 调大这个值可节约耗电
　　## opengles 2.0               LINUX下针对多媒体的一些功能
　　debug.sf.hw=1                    硬件加速设定 0是关闭, 1是开启
　　dalvik.vm.heapsize=24m               虚拟内存范围由12M-48M, 默认是24M
　　ro.config.ringtone=Playa.ogg                       默认来电铃声
　　ro.config.notification_sound=regulus.ogg                            默认通知铃声
　　ro.config.alarm_alert=Alarm_Beep_03.ogg                         默认闹钟铃声
　　ro.modversion=CyanogenMod-7.0.3-GT540-MUR4IK   MOD版本号
　　ro.setupwizard.mode=DISABLED   刷机后设置向导，ENABLED为显示，DISABLED为禁用，OPTIONAL为可选
　　persist.sys.timezone=Asia/shanghai"默认时区
　　media.stagefright.enable-player=true   与多媒体效果有关 
　　media.stagefright.enable-meta=false  与多媒体效果有关 
　　media.stagefright.enable-scan=false  与多媒体效果有关 
　　media.stagefright.enable-http=false  与多媒体效果有关 
　　persist.service.adb.enable=1 开启调试模式
　　ro.secure=0 默认开启未知源APK
　　ro.allow.mock.location=1 开启模拟位置
　　settings.display.autobacklight=1       自动背光默认为开
　　debug.sf.nobootanimation=0             控制开机动画的，0为关闭，1为开启！
　　ro.config.hw_menu_unlockscreen=true 控制唤醒屏幕的设置
　　ro.sf.lcd_density=120 （显示屏分辨率，数值越大分辨率越底）
　　view.touch_slop=15 （触摸屏灵敏度，数值越大越灵敏）
　　view.minimum_fling_velocity=25 （滑动速度）
　　view.scroll_friction=0.008 （滑动误差）
　　# RIL specific configuration. （特定设置）
　　ro.ril.hsdpa.category=8 （hsdpa全称High Speed Downlink Packet Access中文意思：高速下行分组接入,设置的数越大传输越快）
　　ro.ril.gprsclass=12 （GPRS设置）
　　# For HSDPA low throughput （HSDPA低输量）
　　ro.ril.disable.power.collapse=1 （关闭电源）
　　# Modify MMS APN retry timer from 5s to 2s. （修改短信的APN设置5秒为2秒）
　　keyguard.no_require_sim=true （手机卡保护设置）
　　ro.com.android.dateformat=MM-dd-yyyy （默认时间格式，改为yyyy-MM-dd，显示效果就是XXXX年XX月XX日）
三、设置系统属性值（实例）
1.定义: RO_CONFIG_REMOVE_FOCUSMODE
　　在mediatek\build\tools\Configoption.pm中
　　定义，RO_CONFIG_REMOVE_FOCUSMODE
2.赋值:RO_CONFIG_REMOVE_FOCUSMODE = true
　　在mediatek\config\huaqin75_cu_ics\XXX\ProjectConfig.mk中
　　赋值，RO_CONFIG_REMOVE_FOCUSMODE = true
3.使用：在代码XXX.java中使用

实例一：
　　　　import android.os.SystemProperties;        //导包
　　……
final boolean RemoveFocusMode = SystemProperties.getBoolean(
"ro.config.remove.focusmode",false);  //获得属性值

if (RemoveFocusMode == true) {            //使用属性值
        // Remove the focus mode if we can use tap-to-focus.
                removePreference(group, focusMode.getKey());
}
else{
           ……
}
　　可以定义这样的系统属性值（布尔值）来取代宏FeatureOption，从而达到控制代码的目的。
　　
实例二：
另外，这样的用法在情景模式中用得非常多，对初始音量值的定义。
赋值：RO_CONFIG_GENERAL_VOLUME_RING = 7
　　RO_CONFIG_OUTDOOR_VOLUME_RING = 7（ProjectConfig.mk中）
使用： private static final int DEFAULT_RINGER_VOLUME_GENERAL = SystemProperties.getInt("ro.config.general.volume.ring", 4);
　　    private static final int DEFAULT_RINGER_VOLUME_OUTDOOR = SystemProperties.getInt("ro.config.outdoor.volume.ring", 6);
　　也即在生成的build.prop中：
　　ro.config.general.volume.ring=7
　　ro.config.outdoor.volume.ring=7
　　
实例三：
　　还可以定义初始的字符串的值，例如查询命令：*#8375#。
　　赋值：RO_CONFIG_VERSIONCODE = *_86556_（客户要求指令）
　　使用：final String specialVersionCode = SystemProperties.get(
　　 "ro.config.versioncode", "defaultVersionCode");
　　specialCode = specialVersionCode.replace("_", "#");