diff --git a/.github/ISSUE_TEMPLATE/bug_report.yml b/.github/ISSUE_TEMPLATE/bug_report.yml
new file mode 100644
index 0000000..5c356cf
--- /dev/null
+++ b/.github/ISSUE_TEMPLATE/bug_report.yml
@@ -0,0 +1,114 @@
+name: Bug Report
+description: Submit a bug report.
+body:
+ - type: markdown
+ attributes:
+ value: |
+ Before filling out the form, please consider the following:
+ - Make sure to search the [existing issues](https://github.com/AgoraIO-Extensions/Agora-Flutter-RTM-SDK/issues) to see if your bug has already been reported.
+ - For urgent issues, please submit a ticket to [Agora Support](https://www.agora.io/en/customer-support/) for a prompt response.
+ - type: textarea
+ attributes:
+ label: Version of the agora_rtm
+ description: The version of the agora_rtm.
+ placeholder: |
+ 2.2.1
+ validations:
+ required: true
+ - type: checkboxes
+ attributes:
+ label: Platforms affected
+ options:
+ - label: Android
+ - label: iOS
+ - label: macOS
+ - label: Windows
+ - label: Web
+ - type: textarea
+ attributes:
+ label: Steps to reproduce
+ description: Please tell us exactly how to reproduce the problem you are running into.
+ placeholder: |
+ 1. ...
+ 2. ...
+ 3. ...
+ validations:
+ required: true
+ - type: textarea
+ attributes:
+ label: Expected results
+ description: Please tell us what is expected to happen.
+ validations:
+ required: true
+ - type: textarea
+ attributes:
+ label: Actual results
+ description: Please tell us what is actually happening.
+ validations:
+ required: true
+ - type: textarea
+ attributes:
+ label: Code sample
+ description: |
+ To help us better understand and address the issue, please provide a minimal reproducible sample that demonstrates the problem.
+ Instead of uploading screenshots of text, we kindly ask you to use code blocks or the methods mentioned above to share your code sample.
+ This will greatly assist us in diagnosing and resolving the issue effectively.
+ value: |
+ Code sample
+
+ ```dart
+ [Paste your code here]
+ ```
+
+
+ Screenshots / Video demonstration
+
+ [Upload media here]
+
+
+ - type: textarea
+ attributes:
+ label: Logs
+ description: |
+ To help us diagnose and resolve the issue effectively, please include the full logs when you encounter the problem.
+
+ Here are the default log paths for different platforms:
+ - Android: /storage/emulated/0/Android/data//files/agora-iris.log
+ - iOS: App Sandbox/Library/caches/agora-iris.log
+ - macOS: /Users//Library/Containers//Data/Library/Logs/agora-iris.log
+ - Windows: C:\Users\\AppData\Local\Agora\\agora-iris.log
+
+ Please avoid uploading screenshots of text. Instead, use code blocks or the methods mentioned above to share the logs.
+ Remember to remove any sensitive information before sharing.
+ value: |
+ Logs
+
+ ```console
+ [Paste your logs here]
+ ```
+
+ Doctor output
+
+ ```console
+ [Paste your output here]
+ ```
+
+
+ 
+ 
+ 
+ 
+ 
+ 
+
+ 
+
+
+
+
+Agora.io provides building blocks for you to add real-time messaging through a simple and powerful SDK. You can integrate the Agora RTM SDK to enable real-time messaging in your own application quickly.
+
+> NOTE: The `main` branch is major update base on the Agora RTM SDK 2.x, which introduces some break changes. previous releases please see the following branches(the version < 2.x):
+>
+> - [1.x](https://github.com/AgoraIO-Extensions/Agora-Flutter-RTM-SDK/tree/master)
+
+## Usage
+
+To use this plugin, add `agora_rtm` as a [dependency in your pubspec.yaml file](https://flutter.io/platform-plugins/).
+
+## Getting Started
+
+* See the [example](example) directory for a sample app using AgoraRtm.
+
+## Feedback
+
+If you have any problems or suggestions regarding the sample projects, feel free to file an [issue](https://github.com/AgoraIO-Extensions/Agora-Flutter-RTM-SDK/issues) OR pull request.
+
+For urgent issues, please submit a ticket to [Agora Support](https://www.agora.io/en/customer-support/) to receive a timely response.
+
+## How to contribute
+
+To help work on this sdk, see our [contributor guide](https://github.com/AgoraIO/Flutter-RTM/blob/master/CONTRIBUTING.md).
diff --git a/analysis_options.yaml b/analysis_options.yaml
new file mode 100644
index 0000000..a5744c1
--- /dev/null
+++ b/analysis_options.yaml
@@ -0,0 +1,4 @@
+include: package:flutter_lints/flutter.yaml
+
+# Additional information about this file can be found at
+# https://dart.dev/guides/language/analysis-options
diff --git a/android/.gitignore b/android/.gitignore
new file mode 100644
index 0000000..4def2af
--- /dev/null
+++ b/android/.gitignore
@@ -0,0 +1,11 @@
+*.iml
+.gradle
+/local.properties
+/.idea/workspace.xml
+/.idea/libraries
+.DS_Store
+/build
+/captures
+.cxx
+
+libs/
diff --git a/android/build.gradle b/android/build.gradle
new file mode 100644
index 0000000..7578cdf
--- /dev/null
+++ b/android/build.gradle
@@ -0,0 +1,77 @@
+group = "io.agora.agorartm.agora_rtm"
+version = "1.0"
+
+buildscript {
+ repositories {
+ google()
+ mavenCentral()
+ }
+
+ dependencies {
+ classpath("com.android.tools.build:gradle:7.3.0")
+ }
+}
+
+rootProject.allprojects {
+ repositories {
+ google()
+ mavenCentral()
+ }
+}
+
+apply plugin: "com.android.library"
+
+android {
+ if (project.android.hasProperty("namespace")) {
+ namespace = "io.agora.agorartm.agora_rtm"
+ }
+
+ compileSdk = 34
+
+ compileOptions {
+ sourceCompatibility = JavaVersion.VERSION_1_8
+ targetCompatibility = JavaVersion.VERSION_1_8
+ }
+
+ defaultConfig {
+ minSdk = 16
+ consumerProguardFiles 'consumer-rules.pro'
+ }
+
+ sourceSets {
+ if (isDev(project)) {
+ println("Include libs/ to jniLibs.srcDirs for debugging.")
+ main.jniLibs.srcDirs += 'libs'
+ }
+ }
+
+ dependencies {
+ testImplementation("junit:junit:4.13.2")
+ testImplementation("org.mockito:mockito-core:5.0.0")
+ }
+
+ testOptions {
+ unitTests.all {
+ testLogging {
+ events "passed", "skipped", "failed", "standardOut", "standardError"
+ outputs.upToDateWhen {false}
+ showStandardStreams = true
+ }
+ }
+ }
+}
+
+dependencies {
+ if (isDev(project)) {
+ println("Include libs/*jar for debugging.")
+ api fileTree(dir: "libs", include: ["*.jar"])
+ } else {
+ api 'io.agora.rtm:iris-rtm:2.2.1-build.1'
+ api 'io.agora:agora-rtm:2.2.1'
+ }
+}
+
+static boolean isDev(Project project) {
+ def devFile = new File(project.projectDir, '../.plugin_dev')
+ return devFile.exists()
+}
diff --git a/android/consumer-rules.pro b/android/consumer-rules.pro
new file mode 100644
index 0000000..b5b5975
--- /dev/null
+++ b/android/consumer-rules.pro
@@ -0,0 +1,5 @@
+-keepattributes *Annotation*
+-keep class kotlin.** { *; }
+-keep class org.jetbrains.** { *; }
+
+-keep class io.agora.**{*;}
diff --git a/android/settings.gradle b/android/settings.gradle
new file mode 100644
index 0000000..b18bc36
--- /dev/null
+++ b/android/settings.gradle
@@ -0,0 +1 @@
+rootProject.name = 'agora_rtm'
diff --git a/android/src/main/AndroidManifest.xml b/android/src/main/AndroidManifest.xml
new file mode 100644
index 0000000..e34453a
--- /dev/null
+++ b/android/src/main/AndroidManifest.xml
@@ -0,0 +1,5 @@
+
+
+
+
diff --git a/android/src/main/java/io/agora/agorartm/agora_rtm/AgoraRtmPlugin.java b/android/src/main/java/io/agora/agorartm/agora_rtm/AgoraRtmPlugin.java
new file mode 100644
index 0000000..a2745cd
--- /dev/null
+++ b/android/src/main/java/io/agora/agorartm/agora_rtm/AgoraRtmPlugin.java
@@ -0,0 +1,42 @@
+package io.agora.agorartm.agora_rtm;
+
+import androidx.annotation.NonNull;
+
+import io.flutter.Log;
+import io.flutter.embedding.engine.plugins.FlutterPlugin;
+import io.flutter.plugin.common.MethodCall;
+import io.flutter.plugin.common.MethodChannel;
+import io.flutter.plugin.common.MethodChannel.MethodCallHandler;
+import io.flutter.plugin.common.MethodChannel.Result;
+
+/** AgoraRtmPlugin */
+public class AgoraRtmPlugin implements FlutterPlugin, MethodCallHandler {
+ private MethodChannel channel;
+
+ @Override
+ public void onAttachedToEngine(@NonNull FlutterPluginBinding flutterPluginBinding) {
+ channel = new MethodChannel(flutterPluginBinding.getBinaryMessenger(), "agora_rtm");
+ channel.setMethodCallHandler(this);
+ }
+
+ @Override
+ public void onMethodCall(@NonNull MethodCall call, @NonNull Result result) {
+ if ("androidInit".equals(call.method)) {
+ // dart ffi DynamicLibrary.open do not trigger JNI_OnLoad in iris, so we need call java
+ // System.loadLibrary here to trigger the JNI_OnLoad explicitly.
+ try {
+ System.loadLibrary("AgoraRtmWrapper");
+ } catch (Exception e) {
+ Log.e("AgoraRtmPlugin", "androidInit error:\n" + e);
+ }
+ result.success(0);
+ } else {
+ result.notImplemented();
+ }
+ }
+
+ @Override
+ public void onDetachedFromEngine(@NonNull FlutterPluginBinding binding) {
+ channel.setMethodCallHandler(null);
+ }
+}
diff --git a/android/src/test/java/io/agora/agorartm/agora_rtm/AgoraRtmPluginTest.java b/android/src/test/java/io/agora/agorartm/agora_rtm/AgoraRtmPluginTest.java
new file mode 100644
index 0000000..8d05078
--- /dev/null
+++ b/android/src/test/java/io/agora/agorartm/agora_rtm/AgoraRtmPluginTest.java
@@ -0,0 +1,29 @@
+package io.agora.agorartm.agora_rtm;
+
+import static org.mockito.Mockito.mock;
+import static org.mockito.Mockito.verify;
+
+import io.flutter.plugin.common.MethodCall;
+import io.flutter.plugin.common.MethodChannel;
+import org.junit.Test;
+
+/**
+ * This demonstrates a simple unit test of the Java portion of this plugin's implementation.
+ *
+ * Once you have built the plugin's example app, you can run these tests from the command
+ * line by running `./gradlew testDebugUnitTest` in the `example/android/` directory, or
+ * you can run them directly from IDEs that support JUnit such as Android Studio.
+ */
+
+public class AgoraRtmPluginTest {
+ @Test
+ public void onMethodCall_getPlatformVersion_returnsExpectedValue() {
+ AgoraRtmPlugin plugin = new AgoraRtmPlugin();
+
+ final MethodCall call = new MethodCall("getPlatformVersion", null);
+ MethodChannel.Result mockResult = mock(MethodChannel.Result.class);
+ plugin.onMethodCall(call, mockResult);
+
+ verify(mockResult).success("Android " + android.os.Build.VERSION.RELEASE);
+ }
+}
diff --git a/example/.gitignore b/example/.gitignore
new file mode 100644
index 0000000..7bfa1cd
--- /dev/null
+++ b/example/.gitignore
@@ -0,0 +1,45 @@
+# Miscellaneous
+*.class
+*.log
+*.pyc
+*.swp
+.DS_Store
+.atom/
+.buildlog/
+.history
+.svn/
+migrate_working_dir/
+
+# IntelliJ related
+*.iml
+*.ipr
+*.iws
+.idea/
+
+# The .vscode folder contains launch configuration and tasks you configure in
+# VS Code which you may wish to be included in version control, so this line
+# is commented out by default.
+#.vscode/
+
+# Flutter/Dart/Pub related
+**/doc/api/
+**/ios/Flutter/.last_build_id
+.dart_tool/
+.flutter-plugins
+.flutter-plugins-dependencies
+.pub-cache/
+.pub/
+/build/
+
+# Symbolication related
+app.*.symbols
+
+# Obfuscation related
+app.*.map.json
+
+# Android Studio will place build artifacts here
+/android/app/debug
+/android/app/profile
+/android/app/release
+
+pubspec.lock
diff --git a/example/README.md b/example/README.md
new file mode 100644
index 0000000..5adfdf1
--- /dev/null
+++ b/example/README.md
@@ -0,0 +1,16 @@
+# agora_rtm_example
+
+Demonstrates how to use the agora_rtm plugin.
+
+## Getting Started
+
+This project is a starting point for a Flutter application.
+
+A few resources to get you started if this is your first Flutter project:
+
+- [Lab: Write your first Flutter app](https://docs.flutter.dev/get-started/codelab)
+- [Cookbook: Useful Flutter samples](https://docs.flutter.dev/cookbook)
+
+For help getting started with Flutter development, view the
+[online documentation](https://docs.flutter.dev/), which offers tutorials,
+samples, guidance on mobile development, and a full API reference.
diff --git a/example/analysis_options.yaml b/example/analysis_options.yaml
new file mode 100644
index 0000000..0d29021
--- /dev/null
+++ b/example/analysis_options.yaml
@@ -0,0 +1,28 @@
+# This file configures the analyzer, which statically analyzes Dart code to
+# check for errors, warnings, and lints.
+#
+# The issues identified by the analyzer are surfaced in the UI of Dart-enabled
+# IDEs (https://dart.dev/tools#ides-and-editors). The analyzer can also be
+# invoked from the command line by running `flutter analyze`.
+
+# The following line activates a set of recommended lints for Flutter apps,
+# packages, and plugins designed to encourage good coding practices.
+include: package:flutter_lints/flutter.yaml
+
+linter:
+ # The lint rules applied to this project can be customized in the
+ # section below to disable rules from the `package:flutter_lints/flutter.yaml`
+ # included above or to enable additional rules. A list of all available lints
+ # and their documentation is published at https://dart.dev/lints.
+ #
+ # Instead of disabling a lint rule for the entire project in the
+ # section below, it can also be suppressed for a single line of code
+ # or a specific dart file by using the `// ignore: name_of_lint` and
+ # `// ignore_for_file: name_of_lint` syntax on the line or in the file
+ # producing the lint.
+ rules:
+ # avoid_print: false # Uncomment to disable the `avoid_print` rule
+ # prefer_single_quotes: true # Uncomment to enable the `prefer_single_quotes` rule
+
+# Additional information about this file can be found at
+# https://dart.dev/guides/language/analysis-options
diff --git a/example/android/.gitignore b/example/android/.gitignore
new file mode 100644
index 0000000..6f56801
--- /dev/null
+++ b/example/android/.gitignore
@@ -0,0 +1,13 @@
+gradle-wrapper.jar
+/.gradle
+/captures/
+/gradlew
+/gradlew.bat
+/local.properties
+GeneratedPluginRegistrant.java
+
+# Remember to never publicly share your keystore.
+# See https://flutter.dev/docs/deployment/android#reference-the-keystore-from-the-app
+key.properties
+**/*.keystore
+**/*.jks
diff --git a/example/android/app/build.gradle b/example/android/app/build.gradle
new file mode 100644
index 0000000..93e3edc
--- /dev/null
+++ b/example/android/app/build.gradle
@@ -0,0 +1,75 @@
+def localProperties = new Properties()
+def localPropertiesFile = rootProject.file('local.properties')
+if (localPropertiesFile.exists()) {
+ localPropertiesFile.withReader('UTF-8') { reader ->
+ localProperties.load(reader)
+ }
+}
+
+def flutterRoot = localProperties.getProperty('flutter.sdk')
+if (flutterRoot == null) {
+ throw new GradleException("Flutter SDK not found. Define location with flutter.sdk in the local.properties file.")
+}
+
+def flutterVersionCode = localProperties.getProperty('flutter.versionCode')
+if (flutterVersionCode == null) {
+ flutterVersionCode = '1'
+}
+
+def flutterVersionName = localProperties.getProperty('flutter.versionName')
+if (flutterVersionName == null) {
+ flutterVersionName = '1.0'
+}
+
+apply plugin: 'com.android.application'
+apply plugin: 'kotlin-android'
+apply from: "$flutterRoot/packages/flutter_tools/gradle/flutter.gradle"
+
+android {
+ compileSdkVersion 34
+
+ compileOptions {
+ sourceCompatibility JavaVersion.VERSION_1_8
+ targetCompatibility JavaVersion.VERSION_1_8
+ }
+
+ kotlinOptions {
+ jvmTarget = '1.8'
+ }
+
+ sourceSets {
+ main.java.srcDirs += 'src/main/kotlin'
+ }
+
+ defaultConfig {
+ // TODO: Specify your own unique Application ID (https://developer.android.com/studio/build/application-id.html).
+ applicationId = "io.agora.agorartm.agora_rtm_example"
+ // You can update the following values to match your application needs.
+ // For more information, see: https://docs.flutter.dev/deployment/android#reviewing-the-build-configuration.
+ minSdkVersion flutter.minSdkVersion
+ targetSdkVersion flutter.targetSdkVersion
+ versionCode flutterVersionCode.toInteger()
+ versionName flutterVersionName
+ }
+
+ buildTypes {
+ release {
+ // TODO: Add your own signing config for the release build.
+ // Signing with the debug keys for now, so `flutter run --release` works.
+ signingConfig signingConfigs.debug
+ }
+ }
+}
+
+flutter {
+ source '../..'
+}
+
+dependencies {
+ def devFile = project.file("${rootProject.projectDir.getParentFile().parentFile.parentFile}/android/.plugin_dev")
+ if (devFile.exists()) {
+ implementation fileTree(dir: "${rootProject.projectDir.getParentFile().parentFile.parentFile}/android/libs", include: ["*.aar"])
+ }
+ implementation "org.jetbrains.kotlin:kotlin-stdlib-jdk7:$kotlin_version"
+}
+
diff --git a/example/android/app/src/debug/AndroidManifest.xml b/example/android/app/src/debug/AndroidManifest.xml
new file mode 100644
index 0000000..399f698
--- /dev/null
+++ b/example/android/app/src/debug/AndroidManifest.xml
@@ -0,0 +1,7 @@
+
+
+
+
diff --git a/example/android/app/src/main/AndroidManifest.xml b/example/android/app/src/main/AndroidManifest.xml
new file mode 100644
index 0000000..f3535f4
--- /dev/null
+++ b/example/android/app/src/main/AndroidManifest.xml
@@ -0,0 +1,46 @@
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
diff --git a/example/android/app/src/main/java/io/agora/agorartm/agora_rtm_example/MainActivity.java b/example/android/app/src/main/java/io/agora/agorartm/agora_rtm_example/MainActivity.java
new file mode 100644
index 0000000..62fba9f
--- /dev/null
+++ b/example/android/app/src/main/java/io/agora/agorartm/agora_rtm_example/MainActivity.java
@@ -0,0 +1,6 @@
+package io.agora.agorartm.agora_rtm_example;
+
+import io.flutter.embedding.android.FlutterActivity;
+
+public class MainActivity extends FlutterActivity {
+}
diff --git a/example/android/app/src/main/res/drawable-v21/launch_background.xml b/example/android/app/src/main/res/drawable-v21/launch_background.xml
new file mode 100644
index 0000000..f74085f
--- /dev/null
+++ b/example/android/app/src/main/res/drawable-v21/launch_background.xml
@@ -0,0 +1,12 @@
+
+
+
+