Initial commit for Android Kotlin Fundamentals Starter Apps.

Change-Id: Ie023e44ad1b307280f9c7e01255e32a9b1322cfb

Author: Aleks Haecky

TrackMySleepQuality-Starter/README.md

@@ -0,0 +1,54 @@
+TrackMySleepQuality - Starter Code
+==================================
+
+Starter code for Android Kotlin Fundamentals Codelab 6.1 Room
+
+Introduction
+------------
+
+TrackMySleepQuality is an app for recording sleep data for each night. 
+You can record a start and stop time, assign a quality rating, and clear the database. 
+
+In this codelab, working from this starter app,
+you will implement the Room database that holds the sleep data. 
+You will then use instrumented tests to verify that this backend works. 
+
+
+Pre-requisites
+--------------
+
+You need to know:
+
+* Building a basic user interface (UI) for an Android app, 
+  using an activity, fragments, and views.
+* Navigating between fragments and using Safe Args (a Gradle plugin) 
+  to pass data between fragments.
+* View models, view-model factories, and LiveData and its observers. 
+  These Architecture Components topics are covered in an earlier codelab in this course.
+* A basic understanding of SQL databases and the SQLite language.
+
+
+Getting Started
+---------------
+
+1. Download and run the app.
+
+License
+-------
+
+Copyright 2019 Google, Inc.
+
+Licensed to the Apache Software Foundation (ASF) under one or more contributor
+license agreements.  See the NOTICE file distributed with this work for
+additional information regarding copyright ownership.  The ASF licenses this
+file to you under the Apache License, Version 2.0 (the "License"); you may not
+use this file except in compliance with the License.  You may obtain a copy of
+the License at
+
+  http://www.apache.org/licenses/LICENSE-2.0
+
+Unless required by applicable law or agreed to in writing, software
+distributed under the License is distributed on an "AS IS" BASIS, WITHOUT
+WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.  See the
+License for the specific language governing permissions and limitations under
+the License.

TrackMySleepQuality-Starter/app/.gitignore

@@ -0,0 +1 @@
+/build

TrackMySleepQuality-Starter/app/build.gradle

@@ -0,0 +1,80 @@
+/*
+ * Copyright 2019, The Android Open Source Project
+ *
+ * Licensed under the Apache License, Version 2.0 (the "License");
+ * you may not use this file except in compliance with the License.
+ * You may obtain a copy of the License at
+ *
+ *     http://www.apache.org/licenses/LICENSE-2.0
+ *
+ * Unless required by applicable law or agreed to in writing, software
+ * distributed under the License is distributed on an "AS IS" BASIS,
+ * WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+ * See the License for the specific language governing permissions and
+ * limitations under the License.
+ */
+
+apply plugin: 'com.android.application'
+apply plugin: 'kotlin-android'
+apply plugin: 'kotlin-android-extensions'
+apply plugin: 'kotlin-kapt'
+apply plugin: 'androidx.navigation.safeargs'
+
+android {
+    compileSdkVersion 28
+    defaultConfig {
+        applicationId "com.example.android.trackmysleepquality"
+        minSdkVersion 19
+        targetSdkVersion 28
+        versionCode 1
+        versionName "1.0"
+        testInstrumentationRunner "androidx.test.runner.AndroidJUnitRunner"
+        vectorDrawables.useSupportLibrary = true
+    }
+    buildTypes {
+        release {
+            minifyEnabled false
+            proguardFiles getDefaultProguardFile('proguard-android.txt'), 'proguard-rules.pro'
+        }
+    }
+
+    // Enables data binding.
+    dataBinding {
+        enabled = true
+    }
+
+}
+
+dependencies {
+
+    implementation fileTree(dir: 'libs', include: ['*.jar'])
+    implementation "org.jetbrains.kotlin:kotlin-stdlib-jdk7:$kotlin_version"
+
+    // Support libraries
+    implementation "androidx.appcompat:appcompat:1.0.2"
+    implementation "androidx.fragment:fragment:1.0.0"
+    implementation "androidx.constraintlayout:constraintlayout:2.0.0-alpha3"
+
+    // Android KTX
+    implementation 'androidx.core:core-ktx:1.0.1'
+
+    // Room and Lifecycle dependencies
+    implementation "androidx.room:room-runtime:$room_version"
+    implementation 'androidx.legacy:legacy-support-v4:1.0.0'
+    kapt "androidx.room:room-compiler:$room_version"
+    implementation "androidx.lifecycle:lifecycle-extensions:2.0.0"
+
+    // Coroutines
+    implementation "org.jetbrains.kotlinx:kotlinx-coroutines-core:$coroutine_version"
+    implementation "org.jetbrains.kotlinx:kotlinx-coroutines-android:$coroutine_version"
+
+    // Navigation
+    implementation "android.arch.navigation:navigation-fragment-ktx:$navigationVersion"
+    implementation "android.arch.navigation:navigation-ui-ktx:$navigationVersion"
+
+    // Testing
+    testImplementation 'junit:junit:4.12'
+    androidTestImplementation 'androidx.test.ext:junit:1.1.0'
+    androidTestImplementation 'androidx.test.espresso:espresso-core:3.1.1'
+}
+

TrackMySleepQuality-Starter/app/proguard-rules.pro

@@ -0,0 +1,21 @@
+# Add project specific ProGuard rules here.
+# You can control the set of applied configuration files using the
+# proguardFiles setting in build.gradle.
+#
+# For more details, see
+#   http://developer.android.com/guide/developing/tools/proguard.html
+
+# If your project uses WebView with JS, uncomment the following
+# and specify the fully qualified class name to the JavaScript interface
+# class:
+#-keepclassmembers class fqcn.of.javascript.interface.for.webview {
+#   public *;
+#}
+
+# Uncomment this to preserve the line number information for
+# debugging stack traces.
+#-keepattributes SourceFile,LineNumberTable
+
+# If you keep the line number information, uncomment this to
+# hide the original source file name.
+#-renamesourcefileattribute SourceFile

TrackMySleepQuality-Starter/app/src/androidTest/java/com/example/android/trackmysleepquality/SleepDatabaseTest.kt

@@ -0,0 +1,71 @@
+/*
+ * Copyright 2019, The Android Open Source Project
+ *
+ * Licensed under the Apache License, Version 2.0 (the "License");
+ * you may not use this file except in compliance with the License.
+ * You may obtain a copy of the License at
+ *
+ *     http://www.apache.org/licenses/LICENSE-2.0
+ *
+ * Unless required by applicable law or agreed to in writing, software
+ * distributed under the License is distributed on an "AS IS" BASIS,
+ * WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+ * See the License for the specific language governing permissions and
+ * limitations under the License.
+ */
+
+package com.example.android.trackmysleepquality
+//
+//import androidx.room.Room
+//import androidx.test.ext.junit.runners.AndroidJUnit4
+//import androidx.test.platform.app.InstrumentationRegistry
+//import com.example.android.trackmysleepquality.database.SleepDatabase
+//import com.example.android.trackmysleepquality.database.SleepDatabaseDao
+//import com.example.android.trackmysleepquality.database.SleepNight
+//import org.junit.Assert.assertEquals
+//import org.junit.After
+//import org.junit.Before
+//import org.junit.Test
+//import org.junit.runner.RunWith
+//import java.io.IOException
+//
+//
+///**
+// * This is not meant to be a full set of tests. For simplicity, most of your samples do not
+// * include tests. However, when building the Room, it is helpful to make sure it works before
+// * adding the UI.
+// */
+//
+//@RunWith(AndroidJUnit4::class)
+//class SleepDatabaseTest {
+//
+//    private lateinit var sleepDao: SleepDatabaseDao
+//    private lateinit var db: SleepDatabase
+//
+//    @Before
+//    fun createDb() {
+//        val context = InstrumentationRegistry.getInstrumentation().targetContext
+//        // Using an in-memory database because the information stored here disappears when the
+//        // process is killed.
+//        db = Room.inMemoryDatabaseBuilder(context, SleepDatabase::class.java)
+//                // Allowing main thread queries, just for testing.
+//                .allowMainThreadQueries()
+//                .build()
+//        sleepDao = db.sleepDatabaseDao
+//    }
+//
+//    @After
+//    @Throws(IOException::class)
+//    fun closeDb() {
+//        db.close()
+//    }
+//
+//    @Test
+//    @Throws(Exception::class)
+//    fun insertAndGetNight() {
+//        val night = SleepNight()
+//        sleepDao.insert(night)
+//        val tonight = sleepDao.getTonight()
+//        assertEquals(tonight?.sleepQuality, -1)
+//    }
+//}

TrackMySleepQuality-Starter/app/src/main/AndroidManifest.xml

@@ -0,0 +1,24 @@
+<?xml version="1.0" encoding="utf-8"?>
+<manifest xmlns:android="http://schemas.android.com/apk/res/android"
+    package="com.example.android.trackmysleepquality">
+
+    <application
+        android:allowBackup="true"
+        android:icon="@mipmap/ic_launcher_sleep_tracker"
+        android:label="@string/app_name"
+        android:roundIcon="@mipmap/ic_launcher_sleep_tracker_round"
+        android:supportsRtl="true"
+        android:theme="@style/AppTheme">
+        <activity android:name=".MainActivity">
+            <intent-filter>
+                <action android:name="android.intent.action.MAIN" />
+
+                <category android:name="android.intent.category.LAUNCHER" />
+            </intent-filter>
+        </activity>
+        <meta-data
+            android:name="preloaded_fonts"
+            android:resource="@array/preloaded_fonts" />
+    </application>
+
+</manifest>

TrackMySleepQuality-Starter/app/src/main/ic_launcher_sleep_tracker-web.png

@@ -0,0 +1,52 @@
+/*
+ * Copyright 2019, The Android Open Source Project
+ *
+ * Licensed under the Apache License, Version 2.0 (the "License");
+ * you may not use this file except in compliance with the License.
+ * You may obtain a copy of the License at
+ *
+ *     http://www.apache.org/licenses/LICENSE-2.0
+ *
+ * Unless required by applicable law or agreed to in writing, software
+ * distributed under the License is distributed on an "AS IS" BASIS,
+ * WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+ * See the License for the specific language governing permissions and
+ * limitations under the License.
+ */
+
+package com.example.android.trackmysleepquality
+
+import android.os.Bundle
+import androidx.appcompat.app.AppCompatActivity
+
+
+/**
+ * This is the toy app for lesson 6 of the
+ * Android App Development in Kotlin course on Udacity(https://www.udacity.com/course/???).
+ *
+ * The SleepQualityTracker app is a demo app that helps you collect information about your sleep.
+ * - Start time, end time, quality, and time slept
+ *
+ * This app demonstrates the following views and techniques:
+ * - Room database, DAO, and Coroutines
+ *
+ * It also uses and builds on the following techniques from previous lessons:
+ * - Transformation map
+ * - Data Binding in XML files
+ * - ViewModel Factory
+ * - Using Backing Properties to protect MutableLiveData
+ * - Observable state LiveData variables to trigger navigation
+ */
+
+/**
+ * This main activity is just a container for our fragments,
+ * where the real action is.
+ */
+class MainActivity : AppCompatActivity() {
+
+    override fun onCreate(savedInstanceState: Bundle?) {
+        super.onCreate(savedInstanceState)
+
+        setContentView(R.layout.activity_main)
+    }
+}