droidknights / droidknightsapp

국내 최대 규모 안드로이드 컨퍼런스 드로이드나이츠 앱

DroidKnights App

드로이드나이츠는 기술 세션으로 개발자들의 경험을 공유하는 안드로이드 컨퍼런스입니다.

Guide

Contributions Welcome!

드로이드나이츠 행사 정보를 볼 수 있는 앱을 개발하고 있습니다. 여러분들의 참여로 함께 만들어 나가길 기대합니다!

자세한 내용은 CONTRIBUTING.md 를 참고해 주세요.

Design

Figma에서 디자인을 확인하실 수 있습니다.

Development

Required

• IDE : Android Studio 최신 버전 (Download)

• JDK : Java 17을 실행할 수 있는 JDK

  • (권장) Android Studio 설치 시 Embeded 된 JDK (Open JDK)
  • Java 17을 사용하는 JDK (Open JDK, AdoptOpenJDK, GraalVM)

• Kotlin Language : 2.0.0

Language

• Kotlin

Libraries

• AndroidX

  • Activity & Activity Compose
  • AppCompat
  • Core
  • Lifecycle & ViewModel Compose
  • Navigation

• Kotlin Libraries (Coroutine, DateTime, Serialization)

• Compose

  • Material3
  • Navigation

• Landscapist & Landscapist Coil

• Dagger & Hilt

• Square (Retrofit, OkHttp)

Test & Code analysis

• Compose Test(UI, Navigation)
• JUnit4
• Mockk
• Turbine
• Kotest
• Detekt

Gradle Dependency

Gradle Version Catalog 를 활용하여 종속성과 플러그인을 관리하고 있습니다.

자세한 내용은 libs.versions.toml 를 참고해 주세요.

Architecture

Layer

본 프로젝트는 Layered Architecture 형태로 설계되어 있습니다. 현재 Presentation/Domain/Data 레이어 구조를 띄고 있습니다.

UI Layer

상태는 아래로 이동하고 이벤트는 위로 이동하는 단방향 데이터 흐름(UDF)으로 구성되어 있습니다.

Module

본 프로젝트는 Multi-module 구조이며 각 Feature마다 모듈 형태로 구성되어 있습니다.

Module Graph 생성 방법

1. 그래프를 시각화하는 오픈소스 설치
- brew install graphviz (예시 Homebrew)

2. 그래프 생성 Gradle Task 실행
./gradlew projectDependencyGraph

Thanks

참여해주신 모든 분들 감사합니다!

• GitHub : Contributors
• Designer : Eunbi Ko
• Maintainer : laco-dev, wisemuji

droidknightsapp's Issues

[Main] 메인 화면에서 Home UI를 보여주기

Kind (Required)

• feature

Overview (Required)

• Navigation 이용해서 탭 전환
• app모듈에서 MainActivity를 가지는게 아닌 feature 모듈에서 다른 feature를 사용해야 하는 상황

1. feature:main 모듈이 다른 feature를 의존한다
2. Navigation 구조를 이용해 NavGraphBuilder 전달

[designsystem] 폰트가 시안과 다르게 표시되는 문제 해결

Kind (Required)

• Improvement

Overview (Required)

• Roboto 폰트에 Weight 900 적용이 시안과 다른 이유를 찾는다.

Links

• #48 (comment)

[designsystem] Placeholder AsyncImage 컴포저블

Kind (Required)

• design
• compose

Overview (Required)

• 네트워크 이미지 라이브러리 추가
• Placeholder를 지원하는 공통 컴포넌트 추가

이슈/PR 템플릿 추가

기여 편의를 위해 https://github.com/droidknights/DroidKnights2021_App 에서 사용된 이슈/PR 템플릿을 가져옵니다.

[Setting] 설정 화면 Route 추가

Kind (Required)

• Feature
• UI

Overview (Required)

• 설정 탭으로 이동할 수 있는 라우팅 개념 추가

[build-logic] Type-safe project dependencies on Gradle

Kind (Required)

• Improvement

Overview (Required)

• module 의존성 추가하기 위한 타입 안정성 기능

Links

• https://docs.gradle.org/current/userguide/declaring_dependencies.html#sec:type-safe-project-accessors

[Home] 스피커 라인업 & 세션 목록 카드 UI

Kind (Required)

• Feature
• UI

Overview (Required)

Link

• Figma

[Contributor] feature-contributor 모듈 추가

Kind (Required)

• Feature

Overview (Required)

• 컨트리뷰터 화면 구현을 위한 모듈을 추가한다.

단위 테스트 환경 셋업

[designsystem] TopAppBar 컴포넌트 UI

Kind (Required)

• Design System
• UI

Overview (Required)

Material Color System 정의

Kind (Required)

• Improvement

Overview (Required)

Material Color System에 맞게 컬러 스킴을 정의한다.

Links

• #12 (review)
• https://m3.material.io/styles/color/the-color-system/key-colors-tones
• https://github.com/android/nowinandroid/blob/main/core/designsystem/src/main/java/com/google/samples/apps/nowinandroid/core/designsystem/theme/Theme.kt?rgh-link-date=2023-06-27T10%3A44%3A54Z

[Session] 세션 목록 세션 카드 UI

Kind (Required)

• Feature
• UI

Overview (Required)

Links

• Figma

[Main] 메인 화면 BottomBar 구조 추가

Kind (Required)

• Feature

Overview (Required)

• MainActivity 에서 Home, Settings, (Session??) 으로 이동하기 위한 UI 추가

data 하위 모델이 core.model을 의존하지 않도록 개선

Kind (Required)

• Improve

Overview (Required)

• data.xxx.model의 경우 core.model과 별도의 레이어에 위치함에 따라 의존성 분리

Links

• #62 (comment)

[Sponsor] 후원사 목록 json 채워넣기

Overview

• 확정된 후원사 목록 기준으로 json 데이터 추가

KnightsCard 클릭 로직 개선

Kind (Required)

• Improvement

Overview (Required)

• 공통으로 사용하는 KnightsTheme가 항상 클릭가능하도록 되어 있어 클릭 효과를 제거하는 기능 추가

[Main] BottomBar가 사라지는 애니메이션 효과 추가

Kind (Required)

• Improve

Overview (Required)

• 화면을 이동할 때 아래로 사라졌다가 다시 올라오는 듯한 연출

Main 화면 네비게이션 구조 feature 모듈을 의존하는 형태로 개선

Kind (Required)

• Feature
• Improve

Overview (Required)

• 현재 HomeNavigation 인터페이스를 주입받아서 Composable을 호출하고 있는데
• feature set module개념을 이용해서 Main 모듈이 다른 모듈을 의존하도록 개선함

[Home] feature-home 모듈 생성

Kind (Required)

• 프로젝트 환경

Overview (Required)

• feature-home 모듈 생성

[Contributor] 컨트리뷰터 화면 Data 연결

Kind (Required)

• Feature

Overview (Required)

• 컨트리뷰터 조회 Use Case를 생성한다.
• 컨트리뷰터 화면에서 Use Case를 호출할 수 있도록 연결한다.

[Main] feature-main 모듈 추가

Kind (Required)

• Feature

Overview (Required)

• 메인 화면을 시작하기 위한 main 모듈 구축

[Home] 후원사 목록 data layer 구현

Kind (Required)

• Feature
• Data

Overview (Required)

• 후원사 목록을 가져오기 위한 방법 정의 및 구현
• https://github.com/droidknights/DroidKnights2021_App/blob/main/app/src/main/assets/sponsor.json

[build-logic] module-app, module-android 빌드 로직 개선

Kind (Required)

• Build Gradle

Overview (Required)

: application 모듈과 library 모듈의 build 로직 차이와 상관없이 동일한 코드로 동작하는 이슈 해결

[Session] 세션 data layer 구현

Kind (Required)

• Feature
• Data

Overview (Required)

• 세션 정보를 가져오는 방법 정의 및 구현
• 세션 정보 데이터 저장소 참고사항
  https://github.com/droidknights/DroidKnights2021_App/tree/main/app/src/main/assets

[Home] 후원사 카드 UI

Kind (Required)

• Feature
• UI

Overview (Required)

• 시안 참고해서 카드 형태의 UI로 재구성 필요

[Session] 세션 목록 화면 이동 방법 추가

Kind (Required)

• Feature

Overview (Required)

• 세션 목록 화면 라우팅 구현
• 세션 목록 화면 기본 Activity 구조 구현

Links

• https://www.figma.com/file/FL7CdEyPjvhkJrtYEHAbXn/2023-Droid-Knights-App-_-KEB?type=design&node-id=120-765&mode=dev

[build-logic] 컴포즈 플러그인 공통 의존성 추가

Kind (Required)

• build-logic
• convention

Overview (Required)

• 컴포즈를 사용하는 모듈에서 공통 의존성을 플러그인에 추가

[Session] 세션 상세 - UI 구현

Kind (Required)

• Feature
• UI

Overview (Required)

Links

• Figma

[Session] 세션 목록 가져오는 유즈케이스 추가

Kind (Required)

• Feature

Overview (Required)

• 세션 목록을 가져오기 위한 유즈케이스 추가

[Main] MainScreen UI 테스트

Kind (Required)

• Test

Overview (Required)

• MainScreen UI 테스트
  • 탭 클릭시 선택 상태 확인

[Home] 후원사 카드 이미지 애니메이션

Kind (Required)

• Feature
• UI

Overview (Required)

• 직접 스크롤하지 않아도 자동으로 우>좌 0.2 속도로 움직임

Links

• 관련 PR: #71

TopAppBar를 UI 시안에 맞게 개선

Kind (Required)

• Improvement

Overview (Required)

• Material TopAppBar의 경우 높이를 비롯해 제약사항을 가지고 있어 커스텀 TopAppBar를 구현

하드코딩 되어있는 컬러 값 테마 시스템으로 변경

Kind (Required)

• Improvement

Overview (Required)

• 디자인 시스템의 테마를 사용하지 않고 직접 사용하는 코드를 테마로 개선

[Contributor] 컨트리뷰터 화면 UI 컴포넌트 구현

Kind (Required)

• Feature

Overview (Required)

• 컨트리뷰터 화면을 구성하는데에 필요한 UI 컴포넌트를 구현한다.

[Contributor] 컨트리뷰터 화면 상단 배너 추가

Kind (Required)

• Improvement

Overview (Required)

• 컨트리뷰터 화면 상단 배너 이미지 및 글자 뷰를 추가한다.
• 이미 정의되어있는 에셋을 활용한다.

[Contributor] 컨트리뷰터 이동 방법 추가

Kind (Required)

• Feature

Overview (Required)

• block by #37
  

[Session] 세션 목록 기본 UI

Kind (Required)

• Feature
• UI

Overview (Required)

스크롤 하는 경우 트랙 탭이 보이게
(세션이 적으면 탭 기능 없어도 상관없을 것 같아요)

Links

• Figma

[Session] 세션 목록 json 채워넣기

Overview

• 확정된 발표자 목록 기준으로 json 일괄 추가
• 내용은 Fake 데이터로 추가하고 확정된 내용 기반으로 발표자 목록 우선 추가

[Session] 세션 상세 이동 방법 추가

Kind (Required)

• Feature

Overview (Required)

Links

• Figma

detekt 적용

Retrofit 설정

Kind (Required)

• Feature

Overview (Required)

• Retrofit 초기 설정
• DI 추가

컨트리뷰트 문서 추가

Kind (Required)

• Document

Overview (Required)

• CONTRIBUTING.md
• 오픈소스 기여 가이드 정리 필요

[designsystem] 폰트 스타일 재정의

Kind (Required)

• Improvement
• UI

Overview (Required)

• 정의된 스타일 가이드에 맞게 Font Weight별로 스타일을 변경한다.
• 폰트 스타일 사용처에서 올바르게 사용하는지 점검한다.

[Main] import 누락으로 인한 빌드 오류 수정

Kind (Required)

• Bug fix

[Main] 메인 액티비티 app -> main 모듈 이동

Kind (Required)

• Feature

Overview (Required)

• MainActivity 연결

[Contributor] 컨트리뷰터 화면이 뒤로가기로 앱이 종료되지 않도록 한다

Kind (Required)

• Feature
• Improve

Overview (Required)

• 네비게이션 구조에서 컨트리뷰터 화면이 별도의 스택 없이 이동하면서 뒤로가기로 앱이 종료되는 현상

[Setting] 라이트 모드 / 다크 모드 설정 카드 UI

Kind (Required)

• Feature
• UI

Overview (Required)

컬러, 폰트 스타일 추가

Kind (Required)

• Improvement

Overview (Required)

• 디자인 시스템 모듈에 컬러, 폰트 스타일 추가

[Contributor] 컨트리뷰터 Data 구현

Kind (Required)

• Feature

Overview (Required)

• DroidKnights2023_App 컨트리뷰터를 조회할 API를 정의한다.

[Home] 드로이드 나이츠 컨트리뷰터 카드 UI

Kind (Required)

• Feature
• UI

Overview (Required)

Links

• Figma