Simple& Happy Dev

https://developer.android.com/studio/debug/bug-report

위 링크에설명이 있습니다만, 좀 더 자세하게 실제 폰의 스크린샷 첨부해서 설명하겠습니다..

Bugreport의 경우 개발자 옵션 메뉴에 있습니다.

(개발자 옵션 메뉴가 안 보이면, 설정 - 소프트웨어 정보 - 빌드번호 7번 누름)

개발자 옵션 - 전원 버튼 메뉴에 버그 신고 포함 (On)

 - 이렇게 설정한 상태에서 테스트하다가 오류 등이 발생할 경우 전원(Power)키를 누르면 아래와 하단에 "버그 보고서 작성" 버튼이 나오는데, 눌러주면 Bugreport가 동작합니다. (1)

 - Bugreport가 동작하게 되면 산출물을 생성하면서 알림창에 진행 상황이 표시됩니다. (2)

 - Bugreport 알림창에서 (v)를 누르면 메뉴가 표시됩니다. (3)

 - 메뉴에서 세부정보를 누르면 파일명과 버그의 제목과 요약을 적어 넣을 수 있는 창이 나옵니다. (4)

 - Bugreport 진행 상황이 완료가 되면, 알림창을 눌러서 공유할 수 있습니다. (5)

저장된 Bugreport는 "bugreport-생성일자.txt" 파일이 LOCAT 및 각종 정보들을 포함한 주요 분석 대상입니다.

전화 앱의 다이얼화면에서 키스트링으로 Sysdump 진입할 수 있습니다.

*#9900#을 누르면 아래와 같은 화면이 나옵니다. 메뉴가 많아서 스크롤하면 추가로 더 보입니다.

주의: 혹 아래 앱 개발자가 사용하는 2가지 외에 다른 부분을 건드리고자 하면 먼저 Sysdump의 초기 메뉴값을 스크린샷으로 남겨두시길 바랍니다. 나중에 상태를 변경하고나서 초기 상태로 돌리지 않고 계속 유지하게 되면 문제가 될 수 있습니다.

그리고, 일부 메뉴의 설정이 적용되려면 재부팅이 필요한 경우도 있습니다.

앱을 테스트하기 전에 /log 디렉터리를 삭제하고, DELETE DUMPSTATE/LOGCAT을 누른 이후에 테스트를 진행합니다.

앱 개발자의 경우 ①, ② 순서대로 눌러주시면 됩니다.

RUN DUMPSTATE/LOGCAT => COPY TO SDCARD(INCLUDE CP RAMDUMP)

① 실행 시 산출물이 덤프된 상태로 존재합니다. 아직 파일 저장 전입니다. 

② 실행 시 폰 내부 저장 공간에 파일로 저장됩니다.

파일로 생성된 산출물은 /log 디렉터리에 생성됩니다.

"dumpState_버전명_생성일자.log" 파일이 Bugreport의 형식과 유사한 산출물이고 주요 분석대상입니다.

그 외에 산출물들은 단말 플랫폼 개발 시 필요한 부분이 많고, 앱 개발자에게 필요한 부분은 거의 없습니다.

기타 메뉴에 대한 설명

RUM DUMPSTATE/LOGCAT/MODEM LOG : ①의 산출물 + CP(MODEM) 정보, 산출물이 파일로 바로 저장됩니다.

DELETE DUMPSTATE/LOGCAT : 현재 덤프된 산출물을 삭제합니다.

COPY TO EXTERNAL SDCARD(INCLUDE CP RAMDUMP) : 산출물을 외부 SDCARD에 파일로 저장합니다.

DEBUG LEVEL ENABLED : 초기값은 MID, DEBUG LEVEL을 설정합니다. (MID / LOW 선택) 설정 변경 시 재부팅됩니다.

TRANSLATION ASSISTANT : 초기값은 OFF, 활성화 시 HierachyViewer에 추가 정보가 나옵니다. 미확인 상태입니다.

CP RAM LOGGING : 초기값은 OFF, CP 로깅 관련한 것인데, 누르면 재부팅됩니다.

                             앱 개발자와 관련되는 부분이 아니기에 건드리지 않는게 좋습니다.

ENABLE SECLOG : 초기값은 DISABLE, 삼성 내부적으로 사용하는 로그에 대한 출력 여부 설정입니다.

                            활성화 전에 나오지 않던 일부 로그가 출력됩니다. 일반적으로 앱 개발자에게는 의미가 없습니다.
                            팝업에 개인정보가 나올 수 있다고 하니 건드리지 않는 게 좋습니다. 변경 시 재부팅 해야 적용됩니다.

NOTIBAR RUN DUMPSTATE : 초기값은 OFF, 활성화 시 Bugreport 처럼 알림창에서 누르면 DUMPSTATE/LOGCAT/CP

                                           산출물이 덤프 됩니다. ② 실행 시 log 폴더에 파일들로 저장됩니다.

MEDIA DB DUMP : Media DB를 덤프합니다. ② 실행시 log 폴더에 MediaDbDump_?.tar.gz 이름으로 압축해서 저장됩니다.

CP(MODEM) 관련해서는 건드리지 않는 게 좋습니다. 여기에 있는 메뉴들은 외부 앱 개발자를 위한 것보다는 폰을 개발하면서 디버깅이나 양산 이후 단말에 대한 분석을 위한 목적이기에 앞서 주의에도 언급했지만, 초기값과 다르게 변경해서 유지할 경우에 폰이 최적의 상태가 아니라서 성능이나 소모전류에 미세한 영향을 줄 수가 있습니다.

액티비티는 센서와 플래시 작동을 위한 서비스를 시작하게 하는 버튼과 그 아래에 도움말 텍스트로 구성되어 있습니다.

<?xml version="1.0" encoding="utf-8"?>
<android.support.constraint.ConstraintLayout xmlns:android="http://schemas.android.com/apk/res/android"
    xmlns:app="http://schemas.android.com/apk/res-auto"
    xmlns:tools="http://schemas.android.com/tools"
    android:layout_width="match_parent"
    android:layout_height="match_parent"
    tools:context=".MainActivity">

    <Button
        android:id="@+id/button"
        android:layout_width="wrap_content"
        android:layout_height="wrap_content"
        android:layout_marginStart="8dp"
        android:layout_marginEnd="8dp"
        android:layout_marginBottom="8dp"
        android:text="Sensor service"
        app:layout_constraintBottom_toBottomOf="parent"
        app:layout_constraintEnd_toEndOf="parent"
        app:layout_constraintStart_toStartOf="parent"
        app:layout_constraintTop_toTopOf="parent" />

    <TextView
        android:id="@+id/tvHowItWorks"
        android:layout_width="wrap_content"
        android:layout_height="wrap_content"
        android:layout_marginTop="8dp"
        android:text=""
        android:visibility="invisible"
        app:layout_constraintEnd_toEndOf="parent"
        app:layout_constraintStart_toStartOf="parent"
        app:layout_constraintTop_toBottomOf="@+id/button" />

    <TextView
        android:id="@+id/tvShakeYourPhone"
        android:layout_width="wrap_content"
        android:layout_height="wrap_content"
        android:layout_marginTop="8dp"
        android:text="- Shake your phone to stop the service."
        android:visibility="invisible"
        app:layout_constraintEnd_toEndOf="parent"
        app:layout_constraintStart_toStartOf="parent"
        app:layout_constraintTop_toBottomOf="@+id/tvHowItWorks" />
</android.support.constraint.ConstraintLayout> 

서비스 종료 시 인텐트(ACTION_SERVICE_STOP)를 받아서 토스트를 띄우고 3초 후에 앱을 종료하게 만듭니다.

public class MainActivity extends AppCompatActivity {
    private static final String ACTION_SERVICE_STOP = "com.tistory.gh0st.sensorapplication.servicestop";

    private final BroadcastReceiver mIntentReceiver = new BroadcastReceiver() {
        @Override
        public void onReceive(Context context, Intent intent) {
            String action = intent.getAction();

            if (ACTION_SERVICE_STOP.equals(action)) {
                Toast.makeText(getApplicationContext(), "You shook to stop the service..\n The app will finish!", Toast.LENGTH_LONG).show();
                delayedFinish();
            }
        }
    };

    @Override
    protected void onCreate(Bundle savedInstanceState) {
        super.onCreate(savedInstanceState);
        
        ...


        IntentFilter filter = new IntentFilter();
        filter.addAction(ACTION_SERVICE_STOP);
        registerReceiver(mIntentReceiver, filter);
    }


    private void delayedFinish() {
        new Handler().postDelayed(new Runnable() {
            @Override
            public void run() {
                finish();
            }
        }, 3000);
    }
}

존재하는 센서 종류에 따라서 버튼 내의 문구와 도움말 텍스트가 달라지도록 처리합니다.

서비스 시작 버튼을 누르게 되면 버튼을 비활성화시키고, 도움말 문구는 보이도록 만들고, 센서 서비스를 시작합니다.

public class MainActivity extends AppCompatActivity {
    ... 


    @Override
    protected void onCreate(Bundle savedInstanceState) {
        super.onCreate(savedInstanceState);
        setContentView(R.layout.activity_main);

        final TextView tvHowItWorks = findViewById(R.id.tvHowItWorks);
        final TextView tvShakeYourPhone = findViewById(R.id.tvShakeYourPhone);
        final Button startButton = findViewById(R.id.button);

        if (getPackageManager().hasSystemFeature(PackageManager.FEATURE_SENSOR_LIGHT)) {
            startButton.setText("[Light sensor] service");
            tvHowItWorks.setText("- Please adjust the light around the phone.");
        } else if (getPackageManager().hasSystemFeature(PackageManager.FEATURE_SENSOR_PROXIMITY)) {
            startButton.setText("[Proximity sensor] service");
            tvHowItWorks.setText("- Please take your hand near the proximity sensor.");
        } else {
            startButton.setEnabled(false);
            Toast.makeText(getApplicationContext(), "There is no light sensor or proximity sensor.\n The app will finish!"
                                                  , Toast.LENGTH_LONG).show();
            delayedFinish();
        }
        startButton.setOnClickListener(new View.OnClickListener() {
            @Override
            public void onClick(View v) {
                startButton.setEnabled(false);
                tvHowItWorks.setVisibility(View.VISIBLE);
                tvShakeYourPhone.setVisibility(View.VISIBLE);
                startService(new Intent(getApplicationContext(), SensorService.class));
            }
        });

    }
    ...
}

자바 (SensorService.java)

서비스 동작 시 먼저 onStartCommand()가 호출됩니다.

여기서는 존재하는 센서에 따라서 센서 객체의 인스턴스를 얻고, 이벤트 리스너를 등록합니다.

앞서 언급했듯이 조도 센서나 근접 센서 두개 중의 하나가 사용됩니다. 즉, 조도 센서 + 가속도 센서 또는 근접 센서 + 가속도 센서 조합으로 사용됩니다.

근접 센서의 경우 주변의 물체를 인지할 수 있는 기준 거리를 구합니다. (5cm 또는 센서의 최대값 중의 작은 값)

public class SensorService extends Service implements SensorEventListener {
    private static final String TAG = "SensorService";

    private static final String ACTION_SERVICE_STOP = "com.tistory.gh0st.sensorapplication.servicestop";

    private static final boolean ON = true;
    private static final boolean OFF = false;

    private static final float LIGHT_DARK_THRESHOLD = 0.0f;
    private static final float LIGHT_BRIGHT_THRESHOLD = 30.0f;
    private static final float PROXIMITY_THRESHOLD = 5.0f; //5cm
    private static final float SHAKE_THRESHOLD = 20.0f;

    private SensorManager mSensorManager;
    private float mProximityThreshold;

    private CameraManager mCameraManager;
    private String mCameraId;

    public SensorService() {
    }

    @Override
    public int onStartCommand(Intent intent, int flags, int startId) {
        Sensor proximitySensor;
        Sensor lightSensor;
        Sensor accSensor;

        mSensorManager = (SensorManager) getApplicationContext().getSystemService(SENSOR_SERVICE);
        mCameraManager = (CameraManager) getApplicationContext().getSystemService(CAMERA_SERVICE);

        if (getPackageManager().hasSystemFeature(PackageManager.FEATURE_SENSOR_LIGHT)) {
            Log.d(TAG, "App will use the Light sensor!");
            lightSensor = mSensorManager.getDefaultSensor(Sensor.TYPE_LIGHT);
            mSensorManager.registerListener(this, lightSensor, SensorManager.SENSOR_DELAY_NORMAL);
        } else {
            Log.d(TAG, "Light sensor does not exist!!!");
            if (getPackageManager().hasSystemFeature(PackageManager.FEATURE_SENSOR_PROXIMITY)) {
                Log.d(TAG, "App will use the Proximity sensor!");
                proximitySensor = mSensorManager.getDefaultSensor(Sensor.TYPE_PROXIMITY);
                if (proximitySensor != null) {
                    mProximityThreshold = Math.min(proximitySensor.getMaximumRange(), PROXIMITY_THRESHOLD);
                }
                mSensorManager.registerListener(this, proximitySensor, SensorManager.SENSOR_DELAY_NORMAL);
            } else {
                Log.d(TAG, "Proximity sensor also does not exist!!!");
            }
        }

        accSensor = mSensorManager.getDefaultSensor(Sensor.TYPE_ACCELEROMETER);
        mSensorManager.registerListener(this, accSensor, SensorManager.SENSOR_DELAY_NORMAL);

        return super.onStartCommand(intent, flags, startId);
    }

SensorEventListener 인터페이스의 onSensorChanged() 구현은 센서별로 나눠서 처리하도록 합니다.

조도 센서의 경우 센서 이벤트값이 0인 경우(Dark)에 플래시를 켜줍니다. 30 이상 인 경우(Bright)에는 플래시를 꺼줍니다.

근접 센서의 경우 센서 이벤트값이 기준 영역(0~5cm) 이하이면 물체가 접근한 상태(positive=true)이며, 그 외의 경우는 접근하지 않는 상태(positive=false)입니다. 이때, 접근 여부에 따라서 플래시를 켜주도록 합니다.

가속도 센서의 경우 센서 이벤트값인 x, y, z 축의 가속도 값이 20.0 이상이면 흔들었다고 판단해서 플래시를 꺼주고, 종료 인지를 위해서 진동을 발생시킵니다.

그리고, 이벤트 리스너 등록을 해지하고, 서비스를 멈추게(stopSelf()) 만들고, ACTION_SERVICE_STOP 인텐트를 날려서, 이후 액티비티에서 이를 받아서 앱을 종료하도록 만듭니다. 

@Override
public void onSensorChanged(SensorEvent event) {
    // TODO Auto-generated method stub
    if (event.sensor.getType() == Sensor.TYPE_LIGHT) {
        Log.d(TAG, "Light sensor value = " + event.values[0]);
        if (event.values[0] == LIGHT_DARK_THRESHOLD) {
            flashlight(ON);
        } else if(event.values[0] >= LIGHT_BRIGHT_THRESHOLD) {
            flashlight(OFF);
        }
    } else if (event.sensor.getType() == Sensor.TYPE_PROXIMITY) {
        Log.d(TAG, "Proximity sensor value = " + event.values[0]);
        final float distance = event.values[0];
        boolean positive = distance >= 0.0f && distance < mProximityThreshold;
        flashlight(positive);
    } else if (event.sensor.getType() == Sensor.TYPE_ACCELEROMETER) {
        Log.d(TAG, "Accelerometer sensor value = " + event.values[0] + ", " + event.values[1] + ", " + event.values[2]);
        float accVal;
        accVal = (float)Math.sqrt(Math.pow(event.values[0], 2) + Math.pow(event.values[1], 2) + Math.pow(event.values[2], 2));
        Log.d(TAG, "Accelerometer sensor acc  = " + accVal);
        if (accVal >= SHAKE_THRESHOLD) {
            flashlight(OFF);
            Vibrator vibrator = (Vibrator)getSystemService(Context.VIBRATOR_SERVICE);
            try {
                vibrator.vibrate(500, null);
            } catch (Exception e) {
                Log.w(TAG, "Failed to vibrate during stop service.", e);
            }
            mSensorManager.unregisterListener(this);
            stopSelf();
            sendBroadcast(new Intent(ACTION_SERVICE_STOP));
        }
    }
}

FlashAPI를 이용해서 플래시를 제어하는 부분입니다.

이와 관련해서는 아래를 참조하면 됩니다.

2018/10/15 - 손전등 앱 만들기 #3 - Flashlight API 이용방법 (Flashlight app using Flashlight API)

void flashlight(boolean state) {
    if (mCameraId == null) {
        try {
            for (String id : mCameraManager.getCameraIdList()) {
                CameraCharacteristics c = mCameraManager.getCameraCharacteristics(id);
                Boolean flashAvailable = c.get(CameraCharacteristics.FLASH_INFO_AVAILABLE);
                Integer lensFacing = c.get(CameraCharacteristics.LENS_FACING);
                if (flashAvailable != null && flashAvailable
                        && lensFacing != null && lensFacing == CameraCharacteristics.LENS_FACING_BACK) {
                    mCameraId = id;
                    break;
                }
            }
        } catch (CameraAccessException e) {
            mCameraId = null;
            e.printStackTrace();
            mSensorManager.unregisterListener(this);
            stopSelf();
            return;
        }
    }

    try {
        mCameraManager.setTorchMode(mCameraId, state);
    } catch (CameraAccessException e) {
        e.printStackTrace();
        mSensorManager.unregisterListener(this);
        stopSelf();
    }
}

종료 인지를 위해서 사용하는 진동의 경우 android.permission.VIBRATE 권한 사용을 추가해줘야 합니다.

uses-feature 부분들은 구글 Play에 등록하지 않는다면 빼주어도 무방합니다.

<?xml version="1.0" encoding="utf-8"?>
<manifest xmlns:android="http://schemas.android.com/apk/res/android"
    package="com.tistory.gh0st.sensorapplication">

    <uses-feature android:name="android.hardware.sensor.light" android:required="false" />
    <uses-feature android:name="android.hardware.sensor.proximity" android:required="true" />
    <uses-feature android:name="android.hardware.sensor.accelerometer" android:required="true" />
    <uses-feature android:name="android.hardware.camera" />
    <uses-feature android:name="android.hardware.camera.flash" />

    <uses-permission android:name="android.permission.VIBRATE" />

    <application
        android:allowBackup="true"
        android:icon="@mipmap/ic_launcher"
        android:label="@string/app_name"
        android:roundIcon="@mipmap/ic_launcher_round"
        android:supportsRtl="true"
        android:theme="@style/AppTheme">
        <activity android:name=".MainActivity">
            <intent-filter>
                <action android:name="android.intent.action.MAIN" />

                <category android:name="android.intent.category.LAUNCHER" />
            </intent-filter>
        </activity>

        <service
            android:name=".SensorService"
            android:enabled="true"
            android:exported="false"></service>
    </application>

</manifest>