[app][starter] initialisation.

Author: Jing KE

.gitignore

@@ -1,3 +1,7 @@
+################################################################################
+# Android
+################################################################################
+
 # Built application files
 *.apk
 *.ap_
@@ -63,3 +67,21 @@ fastlane/Preview.html
 fastlane/screenshots
 fastlane/test_output
 fastlane/readme.md
+
+# auto generated (MyScript)
+.idea/.name
+.idea/misc.xml
+.idea/modules.xml
+
+################################################################################
+# MyScript
+################################################################################
+
+# configuration files
+*.conf
+
+# resource files
+*.res
+
+# temporary folder
+temp/

.idea/codeStyles/Project.xml

@@ -3,10 +3,31 @@ Welcome to Code Labs for MyScript Interactive Ink
 
 [MyScript Developer](https://developer.myscript.com/) provides a complete developer guide of programming with [Interacrive Ink SDK](https://developer.myscript.com/docs/interactive-ink/1.3/overview/about/), however, the Code Labs in this project are aimed at hands-on coding experience by stepping you throught the process of buiding a small application or integrating Interactive Ink into an existing application.
 
-> [!Disclamer]
+- [Welcome to Code Labs for MyScript Interactive Ink](#welcome-to-code-labs-for-myscript-interactive-ink)
+  - [MyScript Certificate](#myscript-certificate)
+
+MyScript Certificate
+--------------------
+
+Open the project in Android Studio, and run starter app or samples on an emulator or on a physical device, you'll see your application crashes and an error showing up in the `logcat` window:
+
+> [!ERROR]
+> Please replace the content of MyCertificate.java with the certificate you received from the [developer portal](https://developer.myscript.com/getting-started).
+
+![invalid-certificate.png](docs/images/myscript/certificate-error.png)
+
+To make it work, you have to go to the [MyScript Developer](https://developer.myscript.com/getting-started) website, select the plarform `Android`, then click `send email` under `Get your certificate` to receive a valid certificate:
+
+![get-certificate.png](docs/images/myscript/certificate-get.png)
+
+Then replace the certificate `MyCertificate.java` by the one you receive from [MyScript Developer](https://developer.myscript.com/getting-started) in the `myscript-certificate` module:
+
+![replace-certificate.png](docs/images/myscript/certificate-replace.png)
+
+Then rebuild and run your app, the error should no longer show up.
+
+> [!ATTENTION]
+> This project starts from a personal [scaffold (Kotlin)](https://github.com/jingkecn/myscript-iink-scaffold-android-kotlin) for MyScript interactive ink SDK. For your better comprehensions, make sure that you practice as well with the [scaffold (Kotlin)](https://github.com/jingkecn/myscript-iink-scaffold-android-kotlin) to start from the same scratch line.
 >
+> [!DISCLAIMER]
 > This is not an official project of MyScript Interactive Ink, and is **ONLY** for learning exchange purposes, and is **NOT** supposed to have quality guarantee and supports.
->
-> [!Attention]
->
-> This project starts from a personal [scaffold (Kotlin)](https://github.com/jingkecn/myscript-iink-scaffold-android-kotlin) for MyScript interactive ink SDK. For your better comprehensions, make sure that you practice as well with the [scaffold (Kotlin)](https://github.com/jingkecn/myscript-iink-scaffold-android-kotlin) to start from the same scratch line.

.idea/codeStyles/codeStyleConfig.xml

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