Skip to content

wanted-preonboarding-hoyahozz/android-wanted-SensorDashboardApp

 
 

Repository files navigation

Members

김현수 김영진 노유리 황준성 김정호
김현수 김영진 노유리 황준성 김정호

Summary

  • 가속도(acc) 3축 + 각속도(gyro) 3축 데이터를 다루는 서비스
  • SensorManager를 이용해 가속도, 각속도 데이터를 수집합니다.
  • Room을 이용해 로컬 저장소에 가속도, 각속도 데이터를 저장합니다.
  • 저장된 데이터들은 Paging을 이용하여 일정량씩 목록에 나열합니다.
  • 저장된 데이터를 불러와서 그래프로 표현합니다.

기술 스택

image

Structure

├── common
│   ├── base
│   ├── constant
│   ├── di
│   ├── extension
│   └── util
├── data
│   ├── local
│   │   ├── dao
│   │   ├── datasource
│   │   ├── datasourceimpl
│   │   └── entity
│   ├── paging
│   └── repositoryimpl
├── domain
│   ├── model
│   ├── repository
│   └── usecase
└── presentation
    ├── adapter
    ├── view
    │   ├── sensor_history_list
    │   ├── sensor_history_measure
    │   ├── sensor_history_play
    │   └── sensor_history_show
    └── viewmodel

김영진

맡은 역할

  • Base 설계
    • Library Dependency 셋팅
    • CleanArchitecture
    • MVVM Design Pattern
    • Hilt Module 셋팅
  • 화면 이동 구현
    • Jetpack Navigation이용하여 Fragment 스택 관리
    • ToolBar 구현

Base 설계

1) Library Dependency 셋팅

  • 사용할 기술들에 대한 Dependency 셋팅
  • project gradle에 변수 선언하여 버전 관리 (Groovy)
//build.gradle (project)
ext {
        hiltVersion = '2.42'
}

//build.gralde (app)
dependencies {
    //Hilt
    implementation "com.google.dagger:hilt-android:$hiltVersion"
    kapt "com.google.dagger:hilt-android-compiler:$hiltVersion"
}

2) CleanArchitecture

  • 요구사항에 따라 필요한 Room(Dao, DataBase), UseCase, Repository, View, ViewModel 등을 정의하여 팀원들이 기능 개발에 집중할 수 있도록 Base 구축
  • Data
    • 실제 Data와 로컬 저장소가 상호작용 합니다.
    • Mapper를 이용해 Entity를 Domain의 Model로 변환하고, 도메인에 정의한 Repository의 구현체를 포함합니다.
  • Domain
    • Data와 Presentation의 중간 계층입니다.
    • UseCase에서 비즈니스 로직을 직관적인 이름으로 정의합니다.
    • UI에 사용될 Data를 Model로 정의합니다.
  • Presentation
    • UI 계층으로, 사용자와 상호작용하며 Android 프레임워크와 가까운 계층입니다.
    • MVVM 디자인 패턴을 지향합니다
    • ViewController에서 Android FrameWork 관련 작업을 수행합니다.
    • ViewModel에서 UI 데이터를 관리하고, Domain의 UseCase를 사용하여 Data 계층과 소통합니다.
    • DataBinding을 이용해 화면에 데이터를 표시합니다.
  • common
    • base, constant, di, extension, util 등 위 계층들 외 코드들로 구성되어있습니다.

3) Hilt Module 셋팅

  • DataBase, DataSource, Repository, Sensor에 대한 의존성 주입 모듈 구현
  • DataSourceModule
@Module
@InstallIn(SingletonComponent::class)
abstract class DataSourceModule {

    @Binds
    @Singleton
    abstract fun bindSensorHistoryLocalDataSource(
        sensorHistoryLocalDataSourceImpl: SensorHistoryLocalDataSourceImpl,
    ): SensorHistoryLocalDataSource
}
  • SensorModule
@Module
@InstallIn(ActivityComponent::class)
object SensorModule {

    @ActivityScoped
    @Provides
    fun provideSensorManager(@ApplicationContext context: Context): SensorManager =
        context.getSystemService(SENSOR_SERVICE) as SensorManager

}

화면 이동 구현

1) Jetpack Navigation이용하여 Fragment 스택 관리

  • Navigation, BindingAdapter를 이용하여 화면 이동, action에 대한 base를 정의하였습니다.
@BindingAdapter("app:navigateTo")
fun navigateTo(view: View, viewName: ViewName) {
    view.setOnClickListener {
        val action = when (viewName) {
            ViewName.MEASURE -> SensorHistoryListFragmentDirections.actionSensorHistoryListFragmentToSensorHistoryMeasureFragment()
            //todo PLAY, SHOW navArgs
            ViewName.PLAY -> SensorHistoryListFragmentDirections.actionSensorHistoryListFragmentToSensorHistoryPlayFragment()
            ViewName.SHOW -> SensorHistoryListFragmentDirections.actionSensorHistoryListFragmentToSensorHistoryShowFragment()
        }
        view.findNavController().navigate(action)
    }
}

@BindingAdapter("app:navigateUp")
fun navigateUp(view: View, dummy: Any?) {
    view.setOnClickListener {
        view.findNavController().navigateUp()
    }
}

2) ToolBar 구현

Untitled (12)

아쉬운점

핵심 기능에 기여하지 못한 점은 아쉬웠으나, 요구사항, 팀원들과 협의한 내용 등을 바탕으로 아키텍처를 설계하고 기능 개발을 위한 Base를 구축하는 과정도 재밌었습니다.

또한, Repository의 Label, Issue Template, PR Template, Projects를 이용한 칸반 보드 등을 셋팅하는 것도 좋은 경험이었습니다.

노유리

맡은 역할

  • 목록 RecyclerView 보여주기
  • Infinete Scroll

기능 설명

@Dao
interface SensorHistoryDao {
    @Query("SELECT * from sensor_history_table ORDER BY publishedAt DESC LIMIT :loadSize OFFSET (:page - 1) * :loadSize")
    suspend fun getSensorDataList(page: Int, loadSize: Int): List<SensorHistoryEntity>
}

실제로 룸데이터에 동작할 쿼리문입니다.

class HistoryPagingSource(
    private val dao: SensorHistoryDao
) : PagingSource<Int, SensorHistoryEntity>() {

    override suspend fun load(params: LoadParams<Int>): LoadResult<Int, SensorHistoryEntity> {
        val page = params.key ?: 1
        return try {
            val items = dao.getSensorDataList(page, params.loadSize)
            LoadResult.Page(
                data = items,
                prevKey = if (page == 1) null else page - 1,
                nextKey = if (items.isEmpty()) null else page + 1
            )
        } catch (e: Exception) {
            return LoadResult.Error(e)
        }
    }

    override fun getRefreshKey(state: PagingState<Int, SensorHistoryEntity>): Int? {
        return state.anchorPosition?.let { anchorPosition ->
            state.closestPageToPosition(anchorPosition)?.prevKey?.plus(1)
                ?: state.closestPageToPosition(anchorPosition)?.nextKey?.minus(1)
        }
    }
}

로컬 데이터를 불러오는 것을 담당하는 추상 클래스인데, 데이터 소스를 정의하고 데이터를 가져오는 방법을 정의합니다.

class HistoryPagingAdapter :
    PagingDataAdapter<SensorHistory, HistoryPagingAdapter.ViewHolder>(diffCallback) {

    override fun onBindViewHolder(holder: ViewHolder, position: Int) {
        getItem(position)?.let {
            holder.bind(it)
        }
    }

    override fun onCreateViewHolder(parent: ViewGroup, viewType: Int): ViewHolder {
        return ViewHolder(
            ItemHistoryRvBinding.inflate(
                LayoutInflater.from(parent.context), parent, false
            )
        )
    }

    class ViewHolder(
        private val binding: ItemHistoryRvBinding
    ) : RecyclerView.ViewHolder(binding.root) {

        fun bind(item: SensorHistory) {
            with(binding) {
                data = item
                executePendingBindings()
            }
        }
    }

    companion object {
        private val diffCallback = object : DiffUtil.ItemCallback<SensorHistory>() {
            override fun areItemsTheSame(oldItem: SensorHistory, newItem: SensorHistory): Boolean {
                return oldItem.id == newItem.id
            }

            override fun areContentsTheSame(
                oldItem: SensorHistory,
                newItem: SensorHistory
            ): Boolean {
                return oldItem == newItem
            }
        }
    }
}

리시이클러뷰 페이징 어댑터에서는 가공한 데이터들을 리사이클러뷰에 바인드하게 됩니다.

아쉬운점

  • 세개의 레이어로 나뉘는 clean architecture와 mvvm패턴에 대한 학습이 부족해서 프로젝트에 적용하는데 시간을 많이 소모했던 것이 많이 아쉽습니다.

황준성

맡은 역할

  • SensorHistoryMeasureFragment, SensorHistoryMeasureViewModel 구현
    • Timer 구현
    • ACCELEROMETER, Gyroscope센서 설정
    • RoomDB에 센서 데이터 저장

기능 설명

  • SensorHistoryMeasureFragment, SensorHistoryMeasureViewModel 설정

센서와 타이머를 설정 및 구현하고, 요구사항에 맞춰 버튼 및 텍스트 클릭시 센서와 타이머의 작동여부를 결정했습니다.

  • Timer 구현

간단하게 0.1초 간격으로 시간을 증가시켜 최대 60초 까지만 진행되는 타이머입니다.

60초가 되면 타이머가 정지하고 센서매니저의 센서리스너를 unregister 시켜 센서를 정지시킵니다.

image

image

  • ACCELEROMETER, GYROSCOPE센서 설정

센서가 0.1초 (100000 마이크로초) 마다 측정이 되어야 해서 이벤트 리스너에 이를 넣어주었고, 이벤트 리스너 생성시에 2개의 센서 분기를 나누고 센서의 값이 변할때 마다 0.1초 주기로 이를 감지하여 측정 리스트에 x,y,z 값을 넣어주게 했습니다.

image

image

image

  • RoomDB에 센서 데이터 저장

저장 텍스트 클릭시 센서타입,현재날짜,측정시간,좌표값들을 RoomDB에 저장하고 측정용 데이터 들을 초기화 시키고 마찬가지로 센서를 정지시킵니다.

image

image

ezgif-3-a9fab2f49b

아쉬운 점

  • 중간중간 구현사항에서 깜빡한 부분들이 있어 이를 완벽하게 구현하지 못한것 같아 아쉽습니다.
  • 완성도에 좀 더 초점을 맞춰서 코드의 재사용성이나 가독성등을 고려하지않은체 좀 중구난방으로 코드를 작성한것 같아 아쉽습니다.
  • 아직 MVVM+AAC 의 완벽한 이해가 안된것 같아 아쉽습니다.

김현수

맡은 역할

  • 센서 변동 값 그래프 표현
  • 센서 등록 및 데이터 관리

기능 설명

센서 → 그래프 과정

@Inject
lateinit var sensorManager: SensorManager

센서 매니저는 DI를 통해 사용합니다.

private fun setSensorType(sensorType: Int) {
    sensorManager.unregisterListener(sensorEventListener)
    sensor = sensorManager.getDefaultSensor(sensorType)
}

센서 종류를 선택하면 센서의 타입을 정합니다.

if(::sensor.isInitialized) {
    ... 
    registerSensorListener(sensorEventListener, sensor)
    ...

이후 측정 버튼을 클릭하면 리스너를 등록하여 측정을 시작합니다.

// Fragment
sensorHistoryMeasureViewModel.updateCurrentMeasureValue(
	event.values[X],
	event.values[Y],
	event.values[Z]
)

// ViewModel
private val _currentMeasureValue = MutableStateFlow(MeasureValue())
val currentMeasureValue = _currentMeasureValue.asStateFlow()

fun updateCurrentMeasureValue(x: Float, y: Float, z: Float) {
	viewModelScope.launch {
		_currentMeasureValue.update {
			_currentMeasureValue.value.copy(x, y, z)
		}
	}
}

센서값이 측정될 때마다 측정된 값을 _currentMeasureValue에 업데이트 합니다.

viewLifecycleOwner.lifecycleScope.launch {
            viewLifecycleOwner.repeatOnLifecycle(Lifecycle.State.STARTED) {
                sensorHistoryMeasureViewModel.currentMeasureValue.collect() { measureValue ->
                    sensorHistoryMeasureViewModel.addEntry(
                        measureValue.x,
                        measureValue.y,
                        measureValue.z
                    )
	...

측정된 값을 collect하여 그래프에 표기합니다.

아쉬운점

  • 시간이 거듭될 수록 점점 스파게티 코드가 된 것 같다.
  • 센서의 측정 주기 정확도에 있어서 약간의 오차가 있어서 아쉽다.
  • 캔버스를 통해 직접 그리려고 하였으나 아쉽게 라이브러리를 사용하게 되었다.
  • 데이터 처리를 깔끔하게 할 수 있었는데 그러지 못한 것 같다.

김정호

맡은 역할

  • 요구사항의 세 번째 페이지를 구현하였습니다.
    • 측정 결과를 애니메이션과 함께 그래프에 출력하도록 구현하였습니다.
    • 측정 결과를 단순 그래프에 출력하도록 구현하였습니다.

기능 설명

Play

  • 측정 결과를 애니메이션과 함께 그래프에 출력합니다.
  • 한 화면에 표현되는 측정 결과량을 20개로 제한하였습니다.
  • 시작 버튼을 누르면 타이머가 작동됩니다.
  • 재생, 정지 상황에 맞게 아이콘이 업데이트 됩니다.
  • 애니메이션 출력이 종료되면 타이머가 멈춤과 동시에 아이콘 역시 재생 아이콘으로 변경됩니다.

image

  • 측정 결과를 한 번에 그래프에 출력합니다.

아쉬운점

  • 익숙하지 않은 요구사항이라 학습에 시간을 오래 소요했습니다.
  • 코드 퀄리티를 신경쓰지 못한 것이 아쉽습니다.
  • 학습할 시간이 없는 상황으로 인해 라이브러리 대신 커스텀 뷰를 사용하지 못한 점이 아쉽습니다.
  • 그러나 새로운 기술을 익히는 과정이 즐거웠습니다.

About

원티드 프리온보딩 안드로이드 기업과제-2주차

Resources

Stars

Watchers

Forks

Releases

No releases published

Packages

No packages published

Languages

  • Kotlin 100.0%