Skip to content

dillo-lab/Attendance_Check

Repository files navigation

Attendance_Check 오늘도 출근 앱 프로젝트

개발 툴 : Flutter
개발 언어 : Dart
개발 일시 : 2023-02-09 ~ 2023-02-11
개발자 : Won Chi Hyeon

앱 개요

기능 : 구글 지도를 활용해서 지도 UI를 구현합니다.
       현재 위치로 이동 버튼을 눌러서 GPS 상의 현재 위치로 이동합니다.
       출근 가능한 위치로 이동하면 [출근하기] 버튼을 눌러서 출근 체크를 할 수 있습니다.
       출근 가능한 위치가 아니라면 [출근하기] 버튼은 보이지 않습니다.
       
사용한 플러그인 : google_maps_flutter, geolocator

[앱 홈 화면]

image

[목적지와의 거리가 100미터 이하일 때]

image

[목적지와의 거리가 100미터 이상일 때]

image

구글 지도 API 발급받기

구글 클라우드 사이트에서 프로젝트를 만들고 API를 받는 과정은 전에 google_maps 라이브러리 사용을 학습하면서
한번 경험한 적이 있기에 API 발급받는 과정은 쉽게 해결할 수 있었습니다.
Maps SDK for Android, iOS 모두 사용하고 API를 1개 발급받았습니다.

image
image

필요한 라이브러리 설치

flutter pub add google_maps_flutter, flutter pub add geolocator 명령어로 필요한 라이브러리를 설치하였습니다.
google_maps_flutter와 geolocator의 최신 플러그인을 설치하였습니다.

image

네이티브 코드 설정하기(Android, iOS)

google_maps_flutter 개발문서

먼저 안드로이드 관련 설정입니다. compileSdkVersion을 33으로 minSdkVersion 20으로 수정합니다.

AndroidManifest.xml 파일에 상세 위치 권한과 manifest 태그의 apllication 태그 안에 발급받은 API 키를 등록해주어야 합니다.

발급받은 API키는 실제 프로젝트에서는 노출되면 보안에 위협이 될 수 있습니다. 하지만 연습하는 프로젝트이기에 그냥 올려두었습니다.

다음은 iOS 관련 설정입니다. ios/Runner/AppDelegate.swift 파일을 열고 구글 API를 넣는 코드를 복사해서 붙여넣습니다.
ios/Runner/Info.plist 파일에 권한 요청 메시지를 추가합니다.

이로써 안드로이드와 iOS의 플러그인을 사용하기 위한 설정은 끝이 났습니다.

[compileSdkVersion, minSdkVersion 수정]

image
image

[상세 위치 권한 설정]

image

[Android 구글 API 키 등록]

image

[iOS 구글 API 키 등록]

image

[iOS 권한 요청 메시지]

image

AppBar 구현하기

AppBar는 renderAppBar 함수를 만들어서 구현하였습니다.
흰색 배경색에, 제목은 가운데 정렬, 제목의 폰트사이즈 등을 설정하였습니다.

image
image

지도 초기화 위치 생성

google_maps_flutter 라이브러리를 import 해주고 라이브러리에 들어있는 LatLng 클래스를 사용해서
지도의 초기화 위치를 설정해줍니다. 
위도 37.5233273, 경도 126.921252 의 위치값을 companyLatLng 객체에 저장하였습니다.

image
image

body에 지도 구현하기

GoogleMap 위젯을 사용해서 구글 지도를 body에 나타내었습니다.
initialCameraPosition 필수 매개변수에는 CameraPosition 클래스를 입력해주고 필수 정보인 target에는 
위에서 설정한 LatLng 위치정보를 zoom에는 확대 정도 값을 double타입으로 지정합니다.

정상적으로 초기 위치정보(37.5233273, 126.921252)를 보여주는 구글 지도가 화면에 나타납니다.

image
image
image
image

Footer에 시계아이콘, 버튼 구현하기

body의 구글 지도가 차지하는 공간을 Expanded로 감싸고 flex 2 (전체의 2/3)을 주고 전체를 Column으로 감싸줍니다.
남은 1/3의 공간에 시계 아이콘과 출근하기 버튼을 생성하였습니다.

image
image

GPS 위치 권한 관리하기

GPS 위치 권한을 확인하고 앱에서 위치 서비스를 사용할 수 있는지 확인한 후 위치 권한을 사용할 수 없는 상태면 권한을 재요청하는 로직을
구현하였습니다. 위치권한 사용을 위해서 geolocator 라이브러리를 사용합니다.
앱마다 모두 권한을 처리하는 방식이 다릅니다. 이번에는 위치 권한이 없으면 앱을 일부 기능이 아닌 전체 기능을 사용할 수 없다는 가정하에 만들었습니다.

권한이 허가되면 위치 권한이 허가되었습니다. 라는 String 값을 반환하고 아니라면 문제되는 사항에 대한 정보가 담긴 String 값을 반환하는
String Future 타입의 checkPermission 함수를 구현하였습니다.

image

checkPermission 함수의 값에 따라 변경되는 UI

checkPermission의 리턴값에 따라 권한 유무를 알 수 있고 권한 유무에 따라 다른 ui를 보여주기 위해서
FutureBuilder 를 사용하였습니다. 전에 웹툰 앱 프로젝트를 하면서 FutureBuilder의 사용법은 알고 있었습니다.

로딩상태(hasData == null 이거나 connectionState가 waiting 일때) 로딩 위젯을 보여주고
위치 권한이 허가되었습니다.라는 String 값이 넘어오면 Column의 위젯들을 보여주고
그외 (위치 권한이 거절되거나 앱에서 권한 설정이 거부되었을 때) 해당하는 문구를 보여줍니다.

[앱을 켰을 때 위치 권한 사을 사용자에게 요청하는 화면]

image

[위치 권한을 거부하였을 때의 화면]

image

[앱 사용중에만 허용, 이번만 허용을 했을 때의 화면]

image

화면에 마커 그리기

구글 지도 플러그인이 제공하는 마커 클래스를 사용해서 지도에 정확한 목적지(회사)의 위치를 마커로 표시합니다.
마커를 생성하고 Set을 사용해서 지도에 기본 마커를 표시합니다.

image image
image

현재 위치 반경 표시하기

현재 위치의 반경을 Circle 클래스를 사용해서 원 모양으로 지도에 표시하였습니다. 방법은 마커와 거의 같습니다.
원을 생성하고 Set을 사용해서 지도에 반경을 표시합니다.

image image
image

안드로이드 에뮬레이터에서 현재 위치 설정하기

에뮬레이터와 시뮬레이터에는 실제 GPS가 없기 때문에 GPS 위치를 임의로 설정하는 기능을 사용해서
현재 위치를 바꿀 수 있습니다.
emulator 창에서 3개의 점 옵션 버튼 클릭 후 Location에서 원하는 위치 검색 후 Set Location을 눌러서 변경합니다.

image

현재 위치를 지도에 표시하기

현재 위치를 지도에 표시하는 방법은 GoogleMap의 myLocationEnabled 매개변수의 값을 true로 설정해주면
GPS 상의 위치를 지도에 표시할 수 있습니다. 지도의 나침반 버튼을 누르면 현재 위치가 지도에 나타납니다.

image
image

출근하기 버튼 기능 로직 준비하기

출근하기 버튼을 눌렀을 때 현재 위치와 목적지(회사) 위치 간의 거리가 100미터 안에 있다면 출근하기 버튼을 눌렀을 때
출근하시겠습니까?라는 문자와 출근하기 버튼이 있는 화면이, 100미터 밖에 있다면 출근할 수 없는 위치입니다.라는 문자와 함께 취소 버튼이 있는 화면을
보여주도록 로직을 만들어주면 됩니다.

먼저 현재 위치를 비동기로 받고 distanceBetween을 사용해서 현재 위치와 목적지의 위치 간의 거리를 계산해서 distance에 저장하였습니다.

image

출근하기 버튼 구현하기

출근하기 버튼 로직을 완성하여 구현해보겠습니다. 먼저 현재 위치와 회사 위치 간 거리가 100미터 이내인지를 체크하는 bool 타입의
canCheck을 생성합니다. 버튼을 눌렀을 때 AlerDialog가 canCheck의 bool 값에 따라 다른 메시지(content)가 제공되도록 하였습니다.
100미터 이내에 있어 그 값이 true 일 때는 출근을 하시겠습니까라는 메시지와 출근하기 버튼이, 100미터보다 멀리 있어 그 값이 false 일 때는
출근할 수 없는 위치입니다.라는 문구와 취소하기 버튼만이 나타나도록 하였습니다.

테스트는 현재 위치와 회사 위치 간 거리가 100미터 이상일 때와 
에뮬레이터의 현재 위치를 회사 위치 근처로 변경한 후에 버튼을 눌렀을 때 나타나는 다이얼로그를 테스트 하였습니다.

image

[현재 위치와 회사 위치 간의 거리가 100 미터 이상일 때]

image

[현재 위치와 회사 위치 간의 거리가 100 미터 이내일 때]

image

향후 앱 스토어 출시 계획

Sqlite 데이터베이스를 사용해서 대학교 근방에 도착해서 등교하기 버튼을 눌렀을 때 등교한 횟수를 저장하는 기능을 추가하고 
내가 누구인지 저장하는 개인 설정 페이지도 추가하여 원주대 모범생 어플을 만들어 볼 생각입니다.

학교 구성원들과 소통하면서 앱에 추가할 수 있는 기능을 만들어 보고자 출시하고 기능을 추가, 수정해 나갈 계획입니다.
이후 추가되는 기능은 여기서부터 모두 비공개로 하며 출시한 후에 플레이스토어 앱 링크를 올리도록 하겠습니다.