Revert changes from empty template

Author: zsmb13

LICENSE

@@ -0,0 +1,29 @@
+BSD 3-Clause License
+
+Copyright (c) 2020, Stream.io Inc
+All rights reserved.
+
+Redistribution and use in source and binary forms, with or without
+modification, are permitted provided that the following conditions are met:
+
+1. Redistributions of source code must retain the above copyright notice, this
+   list of conditions and the following disclaimer.
+
+2. Redistributions in binary form must reproduce the above copyright notice,
+   this list of conditions and the following disclaimer in the documentation
+   and/or other materials provided with the distribution.
+
+3. Neither the name of the copyright holder nor the names of its
+   contributors may be used to endorse or promote products derived from
+   this software without specific prior written permission.
+
+THIS SOFTWARE IS PROVIDED BY THE COPYRIGHT HOLDERS AND CONTRIBUTORS "AS IS"
+AND ANY EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT LIMITED TO, THE
+IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE ARE
+DISCLAIMED. IN NO EVENT SHALL THE COPYRIGHT HOLDER OR CONTRIBUTORS BE LIABLE
+FOR ANY DIRECT, INDIRECT, INCIDENTAL, SPECIAL, EXEMPLARY, OR CONSEQUENTIAL
+DAMAGES (INCLUDING, BUT NOT LIMITED TO, PROCUREMENT OF SUBSTITUTE GOODS OR
+SERVICES; LOSS OF USE, DATA, OR PROFITS; OR BUSINESS INTERRUPTION) HOWEVER
+CAUSED AND ON ANY THEORY OF LIABILITY, WHETHER IN CONTRACT, STRICT LIABILITY,
+OR TORT (INCLUDING NEGLIGENCE OR OTHERWISE) ARISING IN ANY WAY OUT OF THE USE
+OF THIS SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF SUCH DAMAGE.

README.md

@@ -0,0 +1,35 @@
+# Android Chat Tutorial Sample
+
+This repository allows you to check the result after completing each step described in the [Android Chat Tutorial](https://getstream.io/tutorials/android-chat/#kotlin). It contains samples written in both **Kotlin** (_samplekotlin_ module) and **Java** (_samplejava_ module). For more Android Chat examples, see the [Github repo for UX/Views and its Sample app](https://github.com/GetStream/stream-chat-android).
+
+The project is pre-configured with a shared [Stream](https://getstream.io) account for testing purposes. You can learn more about Stream Chat [here](https://getstream.io/chat/), and then sign up for an account and obtain your own keys [here](https://getstream.io/chat/trial).
+
+## Quick start
+
+1. Clone the repository
+2. Open the project in Android Studio
+3. Run the _samplekotlin_ or _samplejava_ configuration
+4. Make sure to check the [Details](#details) section below for customizations
+
+## Details
+
+The sample apps consist of two screens:
+
+* `MainActivity`: Shows the list of available channels.
+* `ChannelActivity`: Shows the selected channel view, which includes the header, message list, and message input view.
+
+Each module contains multiple `ChannelActivity` implementations, which correspond to the steps of the tutorial. You can easily swap them by changing the `setOnChannelClickListener` located in `MainActivity`:
+
+```kotlin
+channelListView.setOnChannelClickListener { channel ->
+    // open the channel activity
+    startActivity(ChannelActivity.newIntent(this, channel))
+}
+```
+
+Currently, you can choose from four different `ChannelActivity` implementations:
+<!-- TODO: Add links when the new version of the Android Tutorial is published -->
+* `ChannelActivity` - a basic _Message List_ implementation
+* `ChannelActivity2` - includes a new _MessageListView_ style and custom attachment type
+* `ChannelActivity3` - includes a custom _Typing Header_ component created with the [LiveData&Offline](https://github.com/GetStream/stream-chat-android-livedata) library
+* `ChannelActivity4` - includes a custom _Typing Header_ component created with the [Low-Level Client](https://github.com/GetStream/stream-chat-android-client) library

build.gradle

@@ -1,4 +1,3 @@
-// Top-level build file where you can add configuration options common to all sub-projects/modules.
 buildscript {
     ext.kotlin_version = "1.4.30"
     repositories {
@@ -8,15 +7,14 @@ buildscript {
     dependencies {
         classpath "com.android.tools.build:gradle:4.1.2"
         classpath "org.jetbrains.kotlin:kotlin-gradle-plugin:$kotlin_version"
-
-        // NOTE: Do not place your application dependencies here; they belong
-        // in the individual module build.gradle files
     }
 }
 
 allprojects {
     repositories {
         google()
+        mavenCentral()
+        maven { url "https://jitpack.io" }
         jcenter()
     }
 }

gradle.properties

@@ -12,7 +12,7 @@ org.gradle.jvmargs=-Xmx2048m -Dfile.encoding=UTF-8
 # http://www.gradle.org/docs/current/userguide/multi_project_builds.html#sec:decoupled_projects
 # org.gradle.parallel=true
 # AndroidX package structure to make it clearer which packages are bundled with the
-# Android operating system, and which are packaged with your app"s APK
+# Android operating system, and which are packaged with your app's APK
 # https://developer.android.com/topic/libraries/support-library/androidx-rn
 android.useAndroidX=true
 # Automatically convert third-party libraries to use AndroidX

gradle/wrapper/gradle-wrapper.properties

@@ -1,6 +1,7 @@
-#Tue Feb 16 00:16:53 MSK 2021
+#Wed Oct 28 11:57:55 MDT 2020
 distributionBase=GRADLE_USER_HOME
 distributionPath=wrapper/dists
 zipStoreBase=GRADLE_USER_HOME
 zipStorePath=wrapper/dists
-distributionUrl=https\://services.gradle.org/distributions/gradle-6.5-bin.zip
+distributionUrl=https\://services.gradle.org/distributions/gradle-6.7-all.zip
+

samplejava/build.gradle

@@ -26,9 +26,18 @@ android {
         sourceCompatibility JavaVersion.VERSION_1_8
         targetCompatibility JavaVersion.VERSION_1_8
     }
+
+    // Enable ViewBinding
+    buildFeatures {
+        viewBinding true
+    }
 }
 
 dependencies {
+    // Add new dependencies
+    implementation "io.getstream:stream-chat-android-ui-components:4.5.5"
+    implementation 'io.coil-kt:coil:1.1.1'
+
     implementation 'androidx.appcompat:appcompat:1.2.0'
     implementation 'com.google.android.material:material:1.3.0'
     implementation 'androidx.constraintlayout:constraintlayout:2.0.4'

samplejava/src/androidTest/java/com/example/chattutorialjava/ExampleInstrumentedTest.java

@@ -8,14 +8,18 @@
         android:label="@string/app_name"
         android:roundIcon="@mipmap/ic_launcher_round"
         android:supportsRtl="true"
-        android:theme="@style/Theme.TestJava">
+        android:theme="@style/Theme.ChatTutorial">
         <activity android:name=".MainActivity">
             <intent-filter>
                 <action android:name="android.intent.action.MAIN" />
 
                 <category android:name="android.intent.category.LAUNCHER" />
             </intent-filter>
         </activity>
+        <activity android:name=".ChannelActivity" />
+        <activity android:name=".ChannelActivity2" />
+        <activity android:name=".ChannelActivity3" />
+        <activity android:name=".ChannelActivity4" />
     </application>
 
 </manifest>

samplejava/src/main/AndroidManifest.xml

@@ -0,0 +1,99 @@
+package com.example.chattutorialjava;
+
+import android.content.Context;
+import android.content.Intent;
+import android.os.Bundle;
+
+import androidx.activity.OnBackPressedCallback;
+import androidx.annotation.Nullable;
+import androidx.appcompat.app.AppCompatActivity;
+import androidx.lifecycle.ViewModelProvider;
+
+import com.example.chattutorialjava.databinding.ActivityChannelBinding;
+import com.getstream.sdk.chat.viewmodel.MessageInputViewModel;
+import com.getstream.sdk.chat.viewmodel.messages.MessageListViewModel;
+import com.getstream.sdk.chat.viewmodel.messages.MessageListViewModel.Mode.Normal;
+import com.getstream.sdk.chat.viewmodel.messages.MessageListViewModel.Mode.Thread;
+import com.getstream.sdk.chat.viewmodel.messages.MessageListViewModel.State.NavigateUp;
+
+import io.getstream.chat.android.client.models.Channel;
+import io.getstream.chat.android.ui.message.input.viewmodel.MessageInputViewModelBinding;
+import io.getstream.chat.android.ui.message.list.header.MessageListHeaderView;
+import io.getstream.chat.android.ui.message.list.header.viewmodel.MessageListHeaderViewModel;
+import io.getstream.chat.android.ui.message.list.header.viewmodel.MessageListHeaderViewModelBinding;
+import io.getstream.chat.android.ui.message.list.viewmodel.MessageListViewModelBinding;
+import io.getstream.chat.android.ui.message.list.viewmodel.factory.MessageListViewModelFactory;
+
+public class ChannelActivity extends AppCompatActivity {
+
+    private final static String CID_KEY = "key:cid";
+
+    public static Intent newIntent(Context context, Channel channel) {
+        final Intent intent = new Intent(context, ChannelActivity.class);
+        intent.putExtra(CID_KEY, channel.getCid());
+        return intent;
+    }
+
+    @Override
+    protected void onCreate(@Nullable Bundle savedInstanceState) {
+        super.onCreate(savedInstanceState);
+
+        // Step 0 - inflate binding
+        ActivityChannelBinding binding = ActivityChannelBinding.inflate(getLayoutInflater());
+        setContentView(binding.getRoot());
+
+        String cid = getIntent().getStringExtra(CID_KEY);
+        if (cid == null) {
+            throw new IllegalStateException("Specifying a channel id is required when starting ChannelActivity");
+        }
+
+        // Step 1 - Create 3 separate ViewModels for the views so it's easy to customize one of the components
+        MessageListViewModelFactory factory = new MessageListViewModelFactory(cid);
+        ViewModelProvider provider = new ViewModelProvider(this, factory);
+        MessageListHeaderViewModel channelHeaderViewModel = provider.get(MessageListHeaderViewModel.class);
+        MessageListViewModel messageListViewModel = provider.get(MessageListViewModel.class);
+        MessageInputViewModel messageInputViewModel = provider.get(MessageInputViewModel.class);
+
+        // TODO set custom Imgur attachment View Holder Factory
+
+        // Step 2 - Bind the view and ViewModels, they are loosely coupled so it's easy to customize
+        MessageListHeaderViewModelBinding.bind(channelHeaderViewModel, binding.messageListHeaderView, this);
+        MessageListViewModelBinding.bind(messageListViewModel, binding.messageListView, this);
+        MessageInputViewModelBinding.bind(messageInputViewModel, binding.messageInputView, this);
+
+        // Step 3 - Let the message input know when we open a thread
+        messageListViewModel.getMode().observe(this, mode -> {
+            if (mode instanceof Thread) {
+                messageInputViewModel.setActiveThread(((Thread) mode).getParentMessage());
+            } else if (mode instanceof Normal) {
+                messageInputViewModel.resetThread();
+            }
+        });
+
+        // Step 4 - Let the message input know when we are editing a message
+        binding.messageListView.setMessageEditHandler(message -> {
+            messageInputViewModel.getEditMessage().postValue(message);
+        });
+
+        // Step 5 - Handle navigate up state
+        messageListViewModel.getState().observe(this, state -> {
+            if (state instanceof NavigateUp) {
+                finish();
+            }
+        });
+
+        // Step 6 - Handle back button behaviour correctly when you're in a thread
+        MessageListHeaderView.OnClickListener backHandler = () -> {
+            messageListViewModel.onEvent(MessageListViewModel.Event.BackButtonPressed.INSTANCE);
+        };
+
+        binding.messageListHeaderView.setBackButtonClickListener(backHandler);
+
+        getOnBackPressedDispatcher().addCallback(this, new OnBackPressedCallback(true) {
+            @Override
+            public void handleOnBackPressed() {
+                backHandler.onClick();
+            }
+        });
+    }
+}

samplejava/src/main/java/com/example/chattutorialjava/ChannelActivity.java

@@ -0,0 +1,100 @@
+package com.example.chattutorialjava;
+
+import android.content.Context;
+import android.content.Intent;
+import android.os.Bundle;
+
+import androidx.activity.OnBackPressedCallback;
+import androidx.annotation.Nullable;
+import androidx.appcompat.app.AppCompatActivity;
+import androidx.lifecycle.ViewModelProvider;
+
+import com.example.chattutorialjava.databinding.ActivityChannel2Binding;
+import com.getstream.sdk.chat.viewmodel.MessageInputViewModel;
+import com.getstream.sdk.chat.viewmodel.messages.MessageListViewModel;
+import com.getstream.sdk.chat.viewmodel.messages.MessageListViewModel.Mode.Normal;
+import com.getstream.sdk.chat.viewmodel.messages.MessageListViewModel.Mode.Thread;
+import com.getstream.sdk.chat.viewmodel.messages.MessageListViewModel.State.NavigateUp;
+
+import io.getstream.chat.android.client.models.Channel;
+import io.getstream.chat.android.ui.message.input.viewmodel.MessageInputViewModelBinding;
+import io.getstream.chat.android.ui.message.list.header.MessageListHeaderView;
+import io.getstream.chat.android.ui.message.list.header.viewmodel.MessageListHeaderViewModel;
+import io.getstream.chat.android.ui.message.list.header.viewmodel.MessageListHeaderViewModelBinding;
+import io.getstream.chat.android.ui.message.list.viewmodel.MessageListViewModelBinding;
+import io.getstream.chat.android.ui.message.list.viewmodel.factory.MessageListViewModelFactory;
+
+public class ChannelActivity2 extends AppCompatActivity {
+
+    private final static String CID_KEY = "key:cid";
+
+    public static Intent newIntent(Context context, Channel channel) {
+        final Intent intent = new Intent(context, ChannelActivity2.class);
+        intent.putExtra(CID_KEY, channel.getCid());
+        return intent;
+    }
+
+    @Override
+    protected void onCreate(@Nullable Bundle savedInstanceState) {
+        super.onCreate(savedInstanceState);
+
+        // Step 0 - inflate binding
+        ActivityChannel2Binding binding = ActivityChannel2Binding.inflate(getLayoutInflater());
+        setContentView(binding.getRoot());
+
+        String cid = getIntent().getStringExtra(CID_KEY);
+        if (cid == null) {
+            throw new IllegalStateException("Specifying a channel id is required when starting ChannelActivity2");
+        }
+
+        // Step 1 - Create 3 separate ViewModels for the views so it's easy to customize one of the components
+        MessageListViewModelFactory factory = new MessageListViewModelFactory(cid);
+        ViewModelProvider provider = new ViewModelProvider(this, factory);
+        MessageListHeaderViewModel channelHeaderViewModel = provider.get(MessageListHeaderViewModel.class);
+        MessageListViewModel messageListViewModel = provider.get(MessageListViewModel.class);
+        MessageInputViewModel messageInputViewModel = provider.get(MessageInputViewModel.class);
+
+        // Set view holder factory for Imgur attachments
+        binding.messageListView.setMessageViewHolderFactory(new ImgurAttachmentViewHolderFactory());
+
+        // Step 2 - Bind the view and ViewModels, they are loosely coupled so it's easy to customize
+        MessageListHeaderViewModelBinding.bind(channelHeaderViewModel, binding.messageListHeaderView, this);
+        MessageListViewModelBinding.bind(messageListViewModel, binding.messageListView, this);
+        MessageInputViewModelBinding.bind(messageInputViewModel, binding.messageInputView, this);
+
+        // Step 3 - Let the message input know when we open a thread
+        messageListViewModel.getMode().observe(this, mode -> {
+            if (mode instanceof Thread) {
+                messageInputViewModel.setActiveThread(((Thread) mode).getParentMessage());
+            } else if (mode instanceof Normal) {
+                messageInputViewModel.resetThread();
+            }
+        });
+
+        // Step 4 - Handle navigate up state
+        messageListViewModel.getState().observe(this, state -> {
+            if (state instanceof NavigateUp) {
+                finish();
+            }
+        });
+
+        // Step 5 - Let the message input know when we are editing a message
+        binding.messageListView.setMessageEditHandler(message -> {
+            messageInputViewModel.getEditMessage().postValue(message);
+        });
+
+        // Step 6 - Handle back button behaviour correctly when you're in a thread
+        MessageListHeaderView.OnClickListener backHandler = () -> {
+            messageListViewModel.onEvent(MessageListViewModel.Event.BackButtonPressed.INSTANCE);
+        };
+
+        binding.messageListHeaderView.setBackButtonClickListener(backHandler);
+
+        getOnBackPressedDispatcher().addCallback(this, new OnBackPressedCallback(true) {
+            @Override
+            public void handleOnBackPressed() {
+                backHandler.onClick();
+            }
+        });
+    }
+}