부산대Android_이창욱_1주차_과제

README.md

@@ -1 +1,56 @@
 # android-contacts
+
+- 카카오 테크 캠퍼스 과제(연락처 앱) 수행을 위한 저장소입니다.
+
+## *Contents*
+1. 홈 화면　　　　　　2. 연락처 추가 화면　　　　　3. 취소 / 뒤로가기 팝업
+
+<img src=https://github.com/ichanguk/android-contacts/blob/ichanguk/img/registerActivity.png width="200" height="350"><img src=https://github.com/ichanguk/android-contacts/blob/ichanguk/img/mainActivity.png width="200" height="350"><img src=https://github.com/ichanguk/android-contacts/blob/ichanguk/img/cancelEvent.png width="200" height="350">
+
+4. 연락처 목록 화면　　　　　　5. 연락처 목록 화면(회전)
+
+<img src=https://github.com/ichanguk/android-contacts/blob/ichanguk/img/contactList.png width="200" height="350"><img src=https://github.com/ichanguk/android-contacts/blob/ichanguk/img/listRotation.png width="500" height="200">
+
+6. 상세화면1　　　　　7. 상세 화면2
+
+<img src=https://github.com/ichanguk/android-contacts/blob/ichanguk/img/detailActivity.png width="200" height="350"><img src=https://github.com/ichanguk/android-contacts/blob/ichanguk/img/detailActivity2.png width="200" height="350">
+
+## feature
+
+### 1단계 - 연락처 추가
+
+1. 이름과 전화번호 입력 기능
+    - 이름과 전화번호는 필수 값으로 입력하지 않은 경우 토스트 메시지 보여준다.
+
+2. 전화번호 입력 기능
+    - 숫자만 입력 가능
+
+3. 더보기 기능
+    - 더보기를 눌러 입력 폼을 확장할 수 있다.
+    - 추가되는 입력 폼 : 생일, 성별, 메모
+
+4. 성별 입력 기능
+    - 성별을 둘 중 하나를 선택할 수 있다.
+
+5. 저장 기능
+    - 저장 버튼을 누르면 '저장이 완료 되었습니다' 라는 토스트 메시지를 보여준다.
+
+6. 취소 기능
+    - 취소 버튼을 누르면 '취소 되었습니다' 라는 토스트 메시지를 보여준다.
+
+7. 생일 입력 기능
+    - 생일을 달력에서 선택해서 입력할 수 있다.
+
+
+### 2단계 - 연락처 목록
+
+1. 연락처 등록 화면
+    - 연락처 추가 버튼을 누르면 연락처 추가 화면으로 넘어감
+
+2. 연락처를 저장하면 목록에 추가
+    - 앱을 다시 실행하면 목록은 비어있음
+    - 저장된 연락처가 많을 경우 목록 스크롤 가능
+
+3. 연락처 목록의 연락처를 선택하면 상세 화면 출력
+
+4. 연락처 작성 중 뒤로가기 / 취소 버튼을 누르면 확인 팝업 출력

app/build.gradle.kts

@@ -1,6 +1,8 @@
 plugins {
     id("com.android.application")
     id("org.jetbrains.kotlin.android")
+    id("kotlin-parcelize")
+    id("org.jlleitschuh.gradle.ktlint")
 }
 
 android {
@@ -41,6 +43,7 @@ dependencies {
     implementation("androidx.appcompat:appcompat:1.6.1")
     implementation("com.google.android.material:material:1.11.0")
     implementation("androidx.constraintlayout:constraintlayout:2.1.4")
+    implementation("androidx.activity:activity:1.8.0")
     testImplementation("junit:junit:4.13.2")
     androidTestImplementation("androidx.test.ext:junit:1.1.5")
     androidTestImplementation("androidx.test.espresso:espresso-core:3.5.1")

app/src/main/AndroidManifest.xml

@@ -13,14 +13,20 @@
         android:theme="@style/Theme.Contacts"
         tools:targetApi="31">
         <activity
-            android:name=".MainActivity"
+            android:name=".DetailActivity"
+            android:exported="false" />
+        <activity
+            android:name=".RegisterActivity"
             android:exported="true">
             <intent-filter>
                 <action android:name="android.intent.action.MAIN" />
 
                 <category android:name="android.intent.category.LAUNCHER" />
             </intent-filter>
         </activity>
+        <activity
+            android:name=".MainActivity"
+            android:exported="true" />
     </application>
 
-</manifest>
+</manifest>

app/src/main/java/campus/tech/kakao/contacts/Contact.kt

@@ -0,0 +1,14 @@
+package campus.tech.kakao.contacts
+
+import android.os.Parcelable
+import kotlinx.parcelize.Parcelize
+
+@Parcelize
+data class Contact(
+    val name: String,
+    val phoneNum: String,
+    val email: String,
+    val birthday: String,
+    val gender: Int,
+    val memo: String,
+) : Parcelable

app/src/main/java/campus/tech/kakao/contacts/DetailActivity.kt

@@ -0,0 +1,107 @@
+package campus.tech.kakao.contacts
+
+import android.os.Build
+import android.os.Bundle
+import android.view.View
+import android.widget.TextView
+import androidx.appcompat.app.AppCompatActivity
+import androidx.constraintlayout.widget.ConstraintLayout
+
+class DetailActivity : AppCompatActivity() {
+    lateinit var detailNameTextView: TextView
+    lateinit var detailPhoneNumTextView: TextView
+    lateinit var detailEmailTextView: TextView
+    lateinit var detailBirthdayTextView: TextView
+    lateinit var detailGenderTextView: TextView
+    lateinit var detailMemoTextView: TextView
+    lateinit var detailEmailLayout: ConstraintLayout
+    lateinit var detailBirthdayLayout: ConstraintLayout
+    lateinit var detailGenderLayout: ConstraintLayout
+    lateinit var detailMemoLayout: ConstraintLayout
+
+    override fun onCreate(savedInstanceState: Bundle?) {
+        super.onCreate(savedInstanceState)
+        setContentView(R.layout.activity_detail)
+
+        initViews()
+        setContactDetails()
+    }
+
+    /**
+     * 사용할 view들을 초기화하는 함수
+     *
+     * - `detailNameTextView` : 이름을 나타내는 TextView
+     * - `detailPhoneNumTextView` : 전화번호를 나타내는 TextView
+     * - `detailEmailTextView` : 메일을 나타내는 TextView
+     * - `detailBirthdayTextView` : 생일을 나타내는 TextView
+     * - `detailGenderTextView` : 성별을 나타내는 TextView
+     * - `detailMemoTextView` : 메모를 나타내는 TextView
+     * - `detailEmailLayout` : 메일 ConstraintLayout
+     * - `detailBirthdayLayout` : 생일 ConstraintLayout
+     * - `detailGenderLayout` : 성별 ConstraintLayout
+     * - `detailMemoLayout` : 메모 ConstraintLayout
+     */
+    private fun initViews() {
+        detailNameTextView = findViewById(R.id.detail_name_text_view)
+        detailPhoneNumTextView = findViewById(R.id.detail_phone_num_text_view)
+        detailEmailTextView = findViewById(R.id.detail_email_text_view)
+        detailBirthdayTextView = findViewById(R.id.detail_birthday_text_view)
+        detailGenderTextView = findViewById(R.id.detail_gender_text_view)
+        detailMemoTextView = findViewById(R.id.detail_memo_text_view)
+
+        detailEmailLayout = findViewById(R.id.detail_email_layout)
+        detailBirthdayLayout = findViewById(R.id.detail_birthday_layout)
+        detailGenderLayout = findViewById(R.id.detail_gender_layout)
+        detailMemoLayout = findViewById(R.id.detail_memo_layout)
+    }
+
+    /**
+     * 전달된 contact 정보를 view와 layout에 설정하는 함수.
+     */
+    private fun setContactDetails() {
+        val contact: Contact? =
+            if (Build.VERSION.SDK_INT >= Build.VERSION_CODES.TIRAMISU) {
+                intent.getParcelableExtra("contact", Contact::class.java)
+            } else {
+                intent.getParcelableExtra("contact")
+            }
+
+        contact?.let {
+            setDetailTextViews(it)
+            setDetailLayoutVisibility(it)
+        }
+    }
+
+    /**
+     * contact 정보로 TextView의 text를 설정하는 함수.
+     *
+     * @param contact RegisterActivity로 부터 받은 Contact 객체.
+     */
+    private fun setDetailTextViews(contact: Contact) {
+        detailNameTextView.text = contact.name
+        detailPhoneNumTextView.text = contact.phoneNum
+        detailEmailTextView.text = contact.email ?: ""
+        detailBirthdayTextView.text = contact.birthday ?: ""
+        detailGenderTextView.text =
+            when (contact.gender) {
+                1 -> "여성"
+                2 -> "남성"
+                else -> ""
+            }
+        detailMemoTextView.text = contact.memo ?: ""
+    }
+
+    /**
+     * contact 정보로 layout의 visibility를 설정하는 함수.
+     *
+     * 빈 정보는 보이지 않도록 설정.
+     *
+     * @param contact RegisterActivity로 부터 받은 Contact 객체.
+     */
+    private fun setDetailLayoutVisibility(contact: Contact) {
+        detailEmailLayout.visibility = if (contact.email.isEmpty()) View.GONE else View.VISIBLE
+        detailBirthdayLayout.visibility = if (contact.birthday.isEmpty()) View.GONE else View.VISIBLE
+        detailGenderLayout.visibility = if (contact.gender == 0) View.GONE else View.VISIBLE
+        detailMemoLayout.visibility = if (contact.memo.isEmpty()) View.GONE else View.VISIBLE
+    }
+}