안드로이드로 플랫폼에서 추가한 하드웨어 등의 설정을 Settings 어플에 추가하기 위해서는 어떻게 해야 할까?
당연한 말이지만 이를 위해서는 java 코드를 주로 수정해야 한다. Settings 관련 코드는 다음에 위치한다.
packages/apps/Setting/
화면 처리와 관련된 내용을 수정한다고 가정하고 Display Setting을 보면 되는데 일단 가속도계의 입력에 따른 회전을 관리하는 Orientation을 찾아 보자. 이미 안드로이드 어플리케이션을 만들어 본 경우라면 당연한 이해하겠지만 기본적으로 3개의 파일이 관련되어 있다.
packages/apps/Setting/res/values/strings.xml
packages/apps/Setting/res/xml/sound_and_display_settings.xml
src/com/android/settings/SoundAndDisplaySettings.java
순서대로 보면 다음과 같다.
Sound & Display Setting 화면에서 Orientation에 대한 것은 on/off 만을 설정하도록 checkbox 형태로 구현되어 있다. 실제 화면을 보면 "Orientation" 이란 타이틀 문자열과, 타이틀 문자열 아래에서 현재 상태에 따라 나타나는 "Switch orientation automatically when rotating phone"에 대한 문자열이 필요하다.
<!-- Sound & display settings screen, accelerometer-based rotation check box label -->
<string name="accelerometer_title">Orientation</string>
<!-- Sound & display settings screen, accelerometer-based rotation summary text when check box is selected -->
<string name="accelerometer_summary_on">Switch orientation automatically when rotating phone</string>
<!-- Sound & display settings screen, accelerometer-based rotation summary text when check box is clear -->
<string name="accelerometer_summary_off">Switch orientation automatically when rotating phone</string>
실제 코드를 보면 accelerometer_title과 accelerometer_summary_on, accelerometer_summary_off 를 정의하고 있다. 여기서 뒤에 2개는 같은 내용으로 되어 있는데 상태에 따라 다른 내용을 보여주고 싶으면 다르게 정의하면 된다.
일단 문자열을 정의하면 checkbox 형태를 사용하므로 이에 대한 내용을 sound_and_display_settings.xml에 정의한다.
<PreferenceCategory
android:title="@string/display_settings">
<CheckBoxPreference
android:key="accelerometer"
android:title="@string/accelerometer_title"
android:summaryOn="@string/accelerometer_summary_on"
android:summaryOff="@string/accelerometer_summary_off"/>
<ListPreference
android:key="animations"
android:title="@string/animations_title"
android:persistent="false"
android:entries="@array/animations_entries"
android:entryValues="@array/animations_values" />
CheckBox를 위한 key 이름을 정의하고 와 title, summayOn, summeryOff에 사용할 문자열을 strings.xml에 정의한 내용으로 정의(연결)해 둔다.
실제 코드 구현은 SoundAndDisplaySettings.java에 구현되어 있다.
먼저 사용할 KEY 문자열을 정의한다. sound_and_display_settings.xml에 정의한 key 문자열과 같은 값으로 한다. 여기에서 final은 JAVA에서 주로 사용하는 것으로 문자열이 수정하지 않는 고정된 값임을 나타낸다.
private static final String KEY_ACCELEROMETER = "accelerometer";
실제 화면 구성에서 사용할 CheckBoxPreference 클래스의 accelerometer 인스턴스를 선언한다.
private CheckBoxPreference mVibrate;
private CheckBoxPreference mDtmfTone;
private CheckBoxPreference mSoundEffects;
private CheckBoxPreference mHapticFeedback;
private ListPreference mAnimations;
private CheckBoxPreference mAccelerometer;
Settings 어플 화면에서 관련 설정을 보여주고, 동작하도록 하기 위해서는 OnCreate(), updateState(), OnPreferenceTreeClick() 메소드를 수정하면 된다.
protected void onCreate(Bundle savedInstanceState) {
super.onCreate(savedInstanceState);
mAnimations = (ListPreference) findPreference(KEY_ANIMATIONS);
mAnimations.setOnPreferenceChangeListener(this);
mAccelerometer = (CheckBoxPreference) findPreference(KEY_ACCELEROMETER);
mAccelerometer.setPersistent(false);
......
}
당연한 얘기지만 key 값을 통해서 xml 파일로부터 필요한 리소스 정보를 참조할 수 있다.
private void updateState(boolean force) {
......
mAnimations.setValueIndex(idx);
updateAnimationsSummary(mAnimations.getValue());
mAccelerometer.setChecked(Settings.System.getInt(
getContentResolver(), Settings.System.ACCELEROMETER_ROTATION, 0) != 0);
......
}
위의 내용을 보면 화면에 해당 값을 보여줘야 할 경우에 Settings.System.ACCELEROMETER_ROTATION 의 값을 얻어서 현재 mAccelerometer의 값을 어떤 상태로 설정할지를 결정한다.
실제 사용자가 항목을 클릭했을 때의 동작을 정의하는 것은 OnPreferenceTreeClick() 메소드에 정의한다.
public boolean onPreferenceTreeClick(PreferenceScreen preferenceScreen, Preference preference) {
if (preference == mSilent || preference == mVibrate) {
setRingerMode(mSilent.isChecked(), mVibrate.isChecked());
if (preference == mSilent) updateState(false);
} else if (preference == mPlayMediaNotificationSounds) {
......
} else if (preference == mAccelerometer) {
Settings.System.putInt(getContentResolver(),
Settings.System.ACCELEROMETER_ROTATION,
mAccelerometer.isChecked() ? 1 : 0);
}else if (preference == mNotificationPulse) {
......
}
여기는 반대로 현재의 상태를 확인하여 Settings.System.ACCELEROMETER_ROTATION 의 값을 변경하고 있다.
여기까지가 사용자의 입력을 받아서 화면상의 처리를 위한 코드이다.
실제 사용자의 입력은 어떻게 관리될까? 이를 위한 코드는 framework 코드를 참조해야 한다.
위에서 정의한 ACCELEROMETER_ROTATION은 다음 파일에서 정의한다.
frameworks/base/core/java/android/provider/Settings.java
/**
* Control whether the accelerometer will be used to change screen
* orientation. If 0, it will not be used unless explicitly requested
* by the application; if 1, it will be used by default unless explicitly
* disabled by the application.
*/
public static final String ACCELEROMETER_ROTATION = "accelerometer_rotation";
정의된 값은 백업을 위해서 SETTINGS_TO_BACKUP 배열에 등록해 둔다. 실제 0과 1의 값이 어떤 의미인지를 설명하고 문자열로 정의해둔다.
실제 이렇게 정의된 값을 이용하는 것은 ACCELEROMETER_ROTATION은 frameworks/base/packages/SettingsProvider/src/com/android/providers/settings/DatabaseHelper.java에서 값을 로드해 두는데 사용한다.
설정 값에 따라 응용 방법은 다양하게 변경될 수 있다.
다른 예로 ADB를 들 수 있다. ADB의 경우에는 ADB_ENABLED 설정을 위와 유사하게 구현할 수 있다. 실제 ADB_ENABLED가 활성화되어도 동작 시점은 USB 케이블이 연결되어 있는 경우에만 동작하여야 한다. 이를 위해서 위와는 다른 코드 구현이 필요하다.
frameworks/base/service/java/com/android/server/SystemServer.java
여기에서는 ADB를 위하여 AdbSettingsObserver 클래스를 정의해 두고 ADB_ENABLED가 설정되면 persist.service.adb.enable 이라는 SystemProperties를 설정하도록 하고 있다.
private class AdbSettingsObserver extends ContentObserver {
public AdbSettingsObserver() {
super(null);
}
@Override
public void onChange(boolean selfChange) {
boolean enableAdb = (Settings.Secure.getInt(mContentResolver,
Settings.Secure.ADB_ENABLED, 0) > 0);
// setting this secure property will start or stop adbd
SystemProperties.set("persist.service.adb.enable", enableAdb ? "1" : "0"); }
}
AdbSettingsObserver 클래스의 인스턴스 run() 메소드에서 생성된다.
// register observer to listen for settings changes
mContentResolver.registerContentObserver(
Settings.Secure.getUriFor(Settings.Secure.ADB_ENABLED),
false, new AdbSettingsObserver());
이 코드는 Setting 어플에서의 설정 변화를 감시하고 있다가, 설정이 바뀌면 바로 persist.service.adb.enable를 바꾸도록 하고 있다.
