모바일프로그래밍 팀 프로젝트: 버캣리스트 (Buccat List)

팀 치즈 (Team CHEESE)

• 김동윤 (소프트웨어학부, 20212674, Back-End)
• 윤서영 (소프트웨어학부, 20210153, Back-End)
• 이보현 (소프트웨어학부, 20213038, Front-End)
• 장수미 (소프트웨어학부, 20193216, Front-End)
• 최지원 (소프트웨어학부, 20213091, Front-End)

앱 소개 (Introduction)

• 버캣리스트는 버킷리스트(Bucket-list)와 고양이(cat)의 합성어로 일상 속 소소한 버킷리스트를 달성하며 그것을 사람들과 공유할 수 있는 플랫폼입니다. 계절 별 버캣리스트를 완수하면 랜덤으로 아이템을 받을 수 있으며 이것으로 자신의 고양이를 꾸밀 수 있습니다.

• 시연 영상: https://youtu.be/Y4q8qhzRjRw

개발 환경 및 가상기기 (Development Environment & Android Virtual Device)

• Android Studio : Dolphin | 2021.3.1 Patch 1
• Firebase - Firestore
• Resizable (Size: 6.0", Revolution: 1080x2340, Density: 420dpi)

애플리케이션 버전 (Application Version)

• minSdkVersion : 21
• targetSdkVersion : 32
  애플리케이션 실행에 필요한 최소 API level은 21 입니다.

빌드 시 유의사항 (Gradle)

• 뷰 결합(View Binding) 설정
  • findViewById 대신 뷰 결합(View Binding) 사용함
  • 사용 설정을 위해 viewBinding 요소를 build.gradle 파일에 추가

android {
        ...
        viewBinding {
            enabled = true
        }
    }

• RecyclerView 라이브러리 추가

  • 상품 페이지에 RecyclerView를 사용함
  • 애플리케이션 모듈의 build.gradle 파일에 필요한 아티팩트의 종속 항목을 추가

• Firebase 라이브러리

dependencies {
    implementation("androidx.recyclerview:recyclerview:1.2.1")
    // For control over item selection of both touch and mouse driven selection
    implementation("androidx.recyclerview:recyclerview-selection:1.1.0")
    
    // firebase-firestore
    implementation 'com.google.firebase:firebase-firestore-ktx:24.3.1'
    // firebase-storage
    implementation 'com.google.firebase:firebase-storage-ktx:20.0.2'
    implementation 'com.firebaseui:firebase-ui-storage:8.0.0'
    // firebase etc.
    implementation 'com.google.android.gms:play-services-auth:19.2.0'
    implementation 'com.google.firebase:firebase-bom:29.0.0'
    implementation 'com.google.firebase:firebase-messaging-ktx:23.0.0'
    implementation 'com.google.firebase:firebase-analytics-ktx:20.0.0'
    implementation platform('com.google.firebase:firebase-bom:30.4.1')
    implementation 'com.firebaseui:firebase-ui-auth:7.2.0'
}

유의사항 (Precautions)

• 이미지 업로드시 미디어 접근 권한을 허용해야 함
• 미디어 접근 권한 비허용시 사진 업로드가 불가하므로 설정-버캣리스트-권한 에서 '허용'으로 직접 변경해야 함
• 이미지 업로드시 .jpg파일로 변환가능한 파일을 업로드 해야함.
• BUCCAT LIST 프로젝트에는 파이어베이스(Firebase) 라이브러리가 사용되었기 때문에 File google-services.json is missing. The Google Services Plugin cannot function without it. 에러가 발생할 수 있으며 google-service.json 파일을 프로젝트 최상단에 존재하는 'app' 폴더에 넣어준 뒤, build 해야만 원활한 애플리케이션 동작이 가능함.
• 아이템은 인증샷 게시물을 누적합 10개, 20개, 100개에 달성할 때마다 하나씩 잠금해제됨.
• 비정상적인 접근이나 순차적이지 못한 애플리케이션 접근으로 인하여 SharedPreference에 손상이 발생한 경우, SharedPreference에 존재하는 CatInfo.xml 파일을 제거한 뒤, 실행하면 원활한 동작이 가능함.

스크린샷 (Screenshot)