first commit

.editorconfig

@@ -0,0 +1,17 @@
+root = true
+[*]
+end_of_line = lf
+insert_final_newline = true
+trim_trailing_whitespace = true
+charset = utf-8
+indent_size = 2
+indent_style = space
+
+[*.{bat, cmd}]
+end_of_line = crlf
+
+[Makefile]
+indent_style = tab
+
+[*.{adoc, asciidoc, md, markdown}]
+trim_trailing_whitespace = false

.gitattributes

@@ -0,0 +1,4 @@
+* text=auto
+*.cmd text=crlf
+*.bat text=crlf
+

.gitignore

@@ -0,0 +1,9 @@
+.DS_Store
+app/build
+!app/build/.gitkeep
+jasonette/
+!jasonette/.gitkeep
+.gradle
+app/icons/android/backup
+node_modules
+dist/

Dockerfile

@@ -0,0 +1,24 @@
+FROM alvrme/alpine-android:android-28-jdk11
+LABEL maintainer="CLSource <[email protected]>"
+
+# Install Rsync and ImageMagick helpers
+RUN apk add --no-cache rsync imagemagick pngcrush optipng=0.7.7-r0
+
+# Required for running utility scripts
+RUN apk add --no-cache nodejs npm
+
+# Install Additional Android SDK Versions
+# RUN sdkmanager --sdk_root=${ANDROID_SDK_ROOT} --install "build-tools;22.0.1" "platforms;android-22"
+# RUN sdkmanager --sdk_root=${ANDROID_SDK_ROOT} --install "build-tools;26.0.3" "platforms;android-26"
+# RUN sdkmanager --sdk_root=${ANDROID_SDK_ROOT} --install "build-tools;27.0.3" "platforms;android-27"
+
+# Install Gradle
+RUN wget "https://services.gradle.org/distributions/gradle-5.6.2-bin.zip" -P ${ANDROID_SDK_ROOT}/cmdline-tools/${CMDLINE_VERSION}
+
+# Install https://github.com/ddimtirov/gwo-agent
+# So gradle will be downloaded from local prefetched file
+RUN wget https://jitpack.io/com/github/ddimtirov/gwo-agent/1.2.0/gwo-agent-1.2.0.jar -P ${ANDROID_SDK_ROOT}/cmdline-tools/${CMDLINE_VERSION}
+
+ENV GRADLE_OPTS=-javaagent:${ANDROID_SDK_ROOT}/cmdline-tools/${CMDLINE_VERSION}/gwo-agent-1.2.0.jar=distributionUrl=file\://${ANDROID_SDK_ROOT}/cmdline-tools/${CMDLINE_VERSION}/gradle-5.6.2-bin.zip
+
+# WORKDIR /home/android

Makefile

@@ -0,0 +1,102 @@
+# Tested on Docker v20.10.0
+.PHONY: install docs zip fa da bad bar caf ki
+
+VERSION=1.0.0
+TAG=jasonette-setup-docker
+KEYSTORE_NAME=jasonette.keystore
+KEYSTORE_ALIAS=upload
+
+# Helper Commands
+DOCKER=docker run --rm -it --mount
+CURL=${DOCKER} type=bind,source="${PWD}",target=/files curlimages/curl
+GRADLE=${DOCKER} type=bind,source="${PWD}/jasonette/android",target=/home/android ${TAG} ./gradlew
+BUILDER=${DOCKER} type=bind,source="${PWD}",target=/home/android ${TAG}
+
+# Exec inside Builder docker
+## Common Utilities
+UNZIP=${BUILDER} unzip -u
+RM=${BUILDER} rm -rf
+MKDIR=${BUILDER} mkdir -p
+COPY=${BUILDER} cp
+MOVE=${BUILDER} mv
+
+## Special Programs
+KEYTOOL=${BUILDER} keytool
+RSYNC=${BUILDER} rsync
+SH=${BUILDER} /bin/sh -c
+
+# Make Commands
+
+## Installation Command
+##> Use this command to install all the dependencies of Docker and Jasonelle
+##> $ make install
+i install:
+	@echo
+	@echo " ╦┌─┐┌─┐┌─┐┌┐┌┌─┐┬  ┬  ┌─┐"
+	@echo " ║├─┤└─┐│ ││││├┤ │  │  ├┤ "
+	@echo "╚╝┴ ┴└─┘└─┘┘└┘└─┘┴─┘┴─┘└─┘"
+	@echo " Android Setup Tool v${VERSION}"
+	@echo
+	docker build -t ${TAG} .
+
+## Download Android
+##> Use this command to download the latest develop version.
+##> $ make fa
+fa fetch-android fetch-android-develop:
+	${CURL} https://github.com/jasonelle/jasonette-android/archive/refs/heads/develop.zip -L -o /files/jasonette/android.zip
+
+##> Download and unzip the directory
+##> Danger: It will delete the jasonette/android directory if present
+##> $ make da
+da dad download-android download-android-develop:
+	make fetch-android-develop
+	${SH} "cd ./jasonette && unzip ./android.zip && rm -rf ./android && mv ./jasonette-android-develop ./android && rm android.zip"
+
+## Copy Android Files
+##> Use this command to copy files inside app/file and app/settings/android to jasonette/android
+##> $ make caf
+caf copy-android-files:
+	${RSYNC} -av ./app/file/ ./jasonette/android/app/src/main/assets/file
+	${SH} "cp ./app/settings/android/AndroidManifest.xml ./jasonette/android/app/src/main && cp ./app/settings/android/strings.xml ./jasonette/android/app/src/main/res/values && cp ./app/settings/android/build.gradle ./jasonette/android/app"
+
+## Create Android Keystore
+##> Use this command to create a new file *.keystore that will be stored inside app/keys
+##> This file is needed to build a release APK and sign in.
+##> $ make ki
+ki key-install-android:
+	${KEYTOOL} -genkey -v -keystore ${KEYSTORE_NAME} -alias ${KEYSTORE_ALIAS} -keyalg RSA -keysize 2048 -validity 9125
+	${COPY} ./${KEYSTORE_NAME} ./jasonette/android/app
+	${MOVE} ./${KEYSTORE_NAME} ./app/keys/${KEYSTORE_NAME}
+
+## Build Android APK in Debug Mode
+##> Use this command to create an APK in debug mode.
+##> It will copy files inside app/file app/settings/android.
+##> The APK will be copied to build/ directory.
+##> $ make bad
+bad build-android-debug:
+	make copy-android-files
+	${GRADLE} assembleDebug --warning-mode=all --stacktrace -PdisablePreDex
+	${COPY} ./jasonette/android/app/build/outputs/apk/debug/app-debug.apk ./app/build/
+
+## Build Android APK in Release Mode
+##> Use this command to create an APK in release mode.
+##> It will copy files inside app/file app/settings/android.
+##> Also it will copy the keystore file.
+##> Make sure your build.gradle file is configured with the keystore file.
+##> The APK will be copied to build/ directory.
+##> $ make bar
+bar build-android-release:
+	@echo "Make sure to configure build.gradle and include ${KEYSTORE_NAME} in the build settings"
+	make copy-android-files
+	${COPY} ./app/keys/${KEYSTORE_NAME} ./jasonette/android/app
+	${GRADLE} assembleRelease --warning-mode=all --stacktrace -PdisablePreDex
+	${COPY} ./jasonette/android/app/build/outputs/apk/release/app-release.apk ./app/build/
+
+# Dev Commands
+docs:
+	@cp README.adoc ./docs && cd docs && asciidoctor README.adoc && asciidoctor-pdf README.adoc && mv README.html index.html && rm README.adoc
+
+zip:
+	@mkdir -p ./dist
+	@git archive --format zip --output ./dist/jasonelle-android-docker-tool-${VERSION}.zip main
+	@echo "./dist/jasonelle-android-docker-tool-${VERSION}.zip created"

README.adoc

@@ -0,0 +1,193 @@
+:toc: macro
+:toclevels: 3
+:ext-relative:
+
+# Jasonelle Android Setup Tools
+
+These are a bunch of scripts and docker files that will help you
+developing apps with Jasonette in Android.
+
+toc::[]
+
+## Directory Structure
+
+When unzipping you can see the following directory structure:
+
+```text
+. (root)
+├── Dockerfile
+├── Makefile
+├── app
+│   ├── build
+│   ├── file
+│   ├── keys
+│   └── settings
+├── docs
+├── jasonette
+└── tools
+    └── windows
+```
+
+## Installation
+
+The only requirement is _Docker Desktop_ at least _v20.10.0_. You can read the installation docs at
+https://docs.docker.com/get-docker/. Be sure that is up and running before installing the _Jasonelle Android Setup Tools_.
+
+### Linux/Mac
+
+_Linux_ and _Mac_ use the https://en.wikipedia.org/wiki/Make_(software)[Make] command. It is a fairly standard tool.
+
+- https://osxdaily.com/2014/02/12/install-command-line-tools-mac-os-x/[Install Make in MacOS]
+- https://linuxconfig.org/command-make-not-found-on-ubuntu-20-04-focal-fossa[Install Make in Ubuntu Linux]
+
+Open the *terminal* application, go to the _root_ directory and run:
+
+```sh
+$ make install
+```
+
+### Windows
+
+Open a new https://www.zdnet.com/article/windows-10-tip-the-fastest-smartest-ways-to-open-a-command-prompt/[*cmd* application]
+inside the _root_ directory and execute:
+
+```sh
+.\tools\windows\install.cmd
+```
+
+## Android
+
+### Jasonette
+
+The main directory is _jasonette/android_. Here you can put your own jasonette project.
+
+### Keystore Creation
+
+Before sending your app to the _PlayStore_ you need to create a new _Keystore_ that will sign the app.
+
+Follow the instructions in the Android Studio Help Center (https://developer.android.com/studio/publish/app-signing.html#generate-key) to generate a new key. It must be different from any previous keys. Alternatively, you can use the following command line to generate a new key:
+
+```sh
+$ keytool -genkeypair -alias upload -keyalg RSA -keysize 2048 -validity 9125 -keystore keystore.jks
+```
+
+This key must be a 2048 bit RSA key and have 25-year validity.
+Export the certificate for that key to PEM format:
+
+```sh
+$ keytool -export -rfc -alias upload -file upload_certificate.pem -keystore keystore.jks 
+```
+
+- *Important*: Keep in mind that the generated *jks* or *keystore* file will be used for signing all future updates of your app.
+Please make sure you store it in a safe place. If you lost it, you will need to contact _Google Support_ to upload a new *keystore* file. The *keystore* file contains both _private_ and _public_ keys. *pem* and *der* files are only public keys.
+
+- *Extra Important*: When creating the *keystore* the command will ask to input a password. Make sure you use a secure password and remember it. Otherwise your *keystore* will not be possible to sign the _APK_ and you would need to recreate a new *keystore*.
+
+You can use the *Keystore Tool* to ease the keystore creation.
+
+More information on creating and using a *keystore* can be found at https://positive-stud.medium.com/step-by-step-guide-to-generate-a-signed-apk-using-android-studio-1e22ab7b3e86 and https://developer.android.com/training/articles/keystore
+
+#### Example build.gradle
+
+This is a sample _build.gradle_ file which was configured for using the *jasonette.keystore* file.
+
+```gradle
+    // ...
+    signingConfigs {
+        release {
+            storeFile file('jasonette.keystore')
+            storePassword 'your_key_store_password'
+            keyAlias 'your_key_alias'
+            keyPassword 'your_key_file_alias_password'
+        }
+    }
+    buildTypes {
+        release {
+            debuggable false
+            minifyEnabled false
+            proguardFiles getDefaultProguardFile('proguard-android.txt'), 'proguard-rules.pro'
+
+            // set the signing config for the release apk
+            signingConfig signingConfigs.release
+        }
+    }
+    // ...
+```
+
+### Edit your files
+
+The main directory for your files is `app/file`. Where every file here will be copied to `jasonette/android`.
+By default it was included three example apps. Select your initial app in `app/settings/android/strings.xml`.
+
+### Edit your settings
+
+The following files:
+
+- AndroidManifest.xml
+- build.gradle
+- settings.xml
+
+will be stored inside `app/settings/android`. They will overwrite the files inside `jasonette/android`.
+
+## Commands
+
+### Installation Command
+
+Use this command to install all the dependencies of Docker and Jasonelle.
+This is the first command you must execute before everything else.
+Be sure that the _Docker Service_ is running and all the directories
+have *read/write* (_chmod 755_) permissions.
+
+- Linux/Mac: `$ make install`
+- Windows: `.\tools\windows\install.cmd`
+
+### Download and unzip the android directory
+
+*Danger*: It will delete the jasonette/android directory if exists.
+
+- Linux/Mac: `$ make da`
+- Windows: `.\tools\windows\android-download-latest.cmd`
+
+### Create Android Keystore
+Use this command to create a new file _*.keystore_ that will be stored inside _app/keys_.
+This file is needed to build a release APK and sign in.
+
+If you already have a _*.keystore_ file then this step is optional. Be sure to
+name the file *jasonette.keystore*.
+
+- Linux/Mac: `$ make ki`
+- Windows: `.\tools\windows\android-key-tool.cmd`
+
+### Build Android APK in Debug Mode
+Use this command to create an APK in debug mode.
+It will copy files inside _app/file_ and _app/settings/android_.
+The APK will be copied to _app/build_ directory.
+
+- Linux/Mac: `$ make bad`
+- Windows: `.\tools\windows\android-build-debug.cmd`
+
+### Build Android APK in Release Mode
+
+Use this command to create an APK in release mode.
+It will copy files inside app/file app/settings/android.
+Also it will copy the keystore file.
+Make sure your build.gradle file is configured with the keystore file.
+The APK will be copied to build/ directory.
+
+- Linux/Mac: `$ make bar`
+- Windows: `.\tools\windows\android-build-release.cmd`
+
+## License
+
+The following files are under the GNU AFFERO GENERAL PUBLIC LICENSE (Version 3).
+
+- _Dockerfile_
+- _Makefile_
+- All files inside _tools_ directory
+
+Other files are under their respective licenses.
+
+## Credits
+++++
+Made with <i class="fa fa-heart">&#9829;</i> by <a href="https://ninjas.cl" target="_blank">Ninjas.cl</a>.
+++++