Skip to content

Commit e28aec1

Browse files
st1vmsst1vms
committed
Android Example
1 parent 0d791d3 commit e28aec1

Some content is hidden

Large Commits have some content hidden by default. Use the searchbox below for content that may be hidden.

45 files changed

+922
-22
lines changed

‎README.md

+10-5
Original file line numberDiff line numberDiff line change
@@ -56,18 +56,23 @@ sudo ./uninstall.sh
5656

5757
## Manual-Android-Installation
5858

59-
Having android-studio folder inside $HOME directory, cd into JDBIts project folder and execute...
59+
- Open the JDBits bind project inside Android Studio
60+
- After syncing gradle files, open a terminal and execute this command:
61+
```
62+
JAVA_HOME=$HOME/android-studio/jbr ./gradlew jdbits:assemble
63+
```
6064
61-
```
62-
JAVA_HOME=$HOME/android-studio/jbr ./gradlew jdbits:assemble
63-
```
65+
You will find the generated **jdbits-<build_version>.aar** file inside the `build/outputs/aar` folder
66+
67+
Copy the AAR file into your Android project **`libs`** folder, and import is as an **`implementation`** dependency, using the Android Studio dependency manager in your Project Settings.
6468
6569
## Usage
6670
6771
Please refer to the examples provided in the [examples](examples/) folder, for the specific language/platform you're using...
6872
6973
- [C-Example](examples/c-example/)
70-
- [Android-Java-Example](examples/android-java-example/)
74+
- [Android-Java-Example](examples/android-example/app/src/main/java/com/example/dbitsandroidexample/MainActivity.java)
75+
7176
## Notes
7277
7378
This library doesn't still support complex structures, such as arrays, unions, dictonaries, etc...

‎examples/android-example/.gitignore

+15
Original file line numberDiff line numberDiff line change
@@ -0,0 +1,15 @@
1+
*.iml
2+
.gradle
3+
/local.properties
4+
/.idea/caches
5+
/.idea/libraries
6+
/.idea/modules.xml
7+
/.idea/workspace.xml
8+
/.idea/navEditor.xml
9+
/.idea/assetWizardSettings.xml
10+
.DS_Store
11+
/build
12+
/captures
13+
.externalNativeBuild
14+
.cxx
15+
local.properties

‎examples/android-example/.idea/.gitignore

+3
Some generated files are not rendered by default. Learn more about customizing how changed files appear on GitHub.

‎examples/android-example/.idea/.name

+1
Some generated files are not rendered by default. Learn more about customizing how changed files appear on GitHub.

‎examples/android-example/.idea/compiler.xml

+6
Some generated files are not rendered by default. Learn more about customizing how changed files appear on GitHub.

‎examples/android-example/.idea/gradle.xml

+18
Some generated files are not rendered by default. Learn more about customizing how changed files appear on GitHub.

‎examples/android-example/.idea/misc.xml

+10
Some generated files are not rendered by default. Learn more about customizing how changed files appear on GitHub.

‎examples/android-example/.idea/vcs.xml

+6
Some generated files are not rendered by default. Learn more about customizing how changed files appear on GitHub.

‎examples/android-example/app/.gitignore

+1
Original file line numberDiff line numberDiff line change
@@ -0,0 +1 @@
1+
/build

‎examples/android-example/app/build.gradle

+40
Original file line numberDiff line numberDiff line change
@@ -0,0 +1,40 @@
1+
plugins {
2+
id 'com.android.application'
3+
}
4+
5+
android {
6+
namespace 'com.example.dbitsandroidexample'
7+
compileSdk 33
8+
9+
defaultConfig {
10+
applicationId "com.example.dbitsandroidexample"
11+
minSdk 19
12+
targetSdk 33
13+
versionCode 1
14+
versionName "1.0"
15+
16+
testInstrumentationRunner "androidx.test.runner.AndroidJUnitRunner"
17+
}
18+
19+
buildTypes {
20+
release {
21+
minifyEnabled false
22+
proguardFiles getDefaultProguardFile('proguard-android-optimize.txt'), 'proguard-rules.pro'
23+
}
24+
}
25+
compileOptions {
26+
sourceCompatibility JavaVersion.VERSION_1_8
27+
targetCompatibility JavaVersion.VERSION_1_8
28+
}
29+
}
30+
31+
dependencies {
32+
33+
implementation 'androidx.appcompat:appcompat:1.6.1'
34+
implementation 'com.google.android.material:material:1.8.0'
35+
implementation 'androidx.constraintlayout:constraintlayout:2.1.4'
36+
implementation files('libs/jdbits-debug.aar')
37+
testImplementation 'junit:junit:4.13.2'
38+
androidTestImplementation 'androidx.test.ext:junit:1.1.5'
39+
androidTestImplementation 'androidx.test.espresso:espresso-core:3.5.1'
40+
}

‎examples/android-example/app/proguard-rules.pro

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

‎examples/android-example/app/src/androidTest/java/com/example/dbitsandroidexample/ExampleInstrumentedTest.java

+26
Original file line numberDiff line numberDiff line change
@@ -0,0 +1,26 @@
1+
package com.example.dbitsandroidexample;
2+
3+
import android.content.Context;
4+
5+
import androidx.test.platform.app.InstrumentationRegistry;
6+
import androidx.test.ext.junit.runners.AndroidJUnit4;
7+
8+
import org.junit.Test;
9+
import org.junit.runner.RunWith;
10+
11+
import static org.junit.Assert.*;
12+
13+
/**
14+
* Instrumented test, which will execute on an Android device.
15+
*
16+
* @see <a href="http://d.android.com/tools/testing">Testing documentation</a>
17+
*/
18+
@RunWith(AndroidJUnit4.class)
19+
public class ExampleInstrumentedTest {
20+
@Test
21+
public void useAppContext() {
22+
// Context of the app under test.
23+
Context appContext = InstrumentationRegistry.getInstrumentation().getTargetContext();
24+
assertEquals("com.example.dbitsandroidexample", appContext.getPackageName());
25+
}
26+
}

‎examples/android-example/app/src/main/AndroidManifest.xml

+25
Original file line numberDiff line numberDiff line change
@@ -0,0 +1,25 @@
1+
<?xml version="1.0" encoding="utf-8"?>
2+
<manifest xmlns:android="http://schemas.android.com/apk/res/android"
3+
xmlns:tools="http://schemas.android.com/tools">
4+
5+
<application
6+
android:allowBackup="true"
7+
android:dataExtractionRules="@xml/data_extraction_rules"
8+
android:fullBackupContent="@xml/backup_rules"
9+
android:icon="@mipmap/ic_launcher"
10+
android:label="@string/app_name"
11+
android:supportsRtl="true"
12+
android:theme="@style/Theme.DBitsAndroidExample"
13+
tools:targetApi="31">
14+
<activity
15+
android:name=".MainActivity"
16+
android:exported="true">
17+
<intent-filter>
18+
<action android:name="android.intent.action.MAIN" />
19+
20+
<category android:name="android.intent.category.LAUNCHER" />
21+
</intent-filter>
22+
</activity>
23+
</application>
24+
25+
</manifest>

‎examples/android-example/app/src/main/java/com/example/dbitsandroidexample/MainActivity.java

+107
Original file line numberDiff line numberDiff line change
@@ -0,0 +1,107 @@
1+
package com.example.dbitsandroidexample;
2+
3+
import androidx.appcompat.app.AppCompatActivity;
4+
5+
import android.os.Bundle;
6+
import android.util.Log;
7+
8+
import com.st1vms.android.jdbits.DBits;
9+
import com.st1vms.android.jdbits.DPacket;
10+
import com.st1vms.android.jdbits.DTypes;
11+
import com.st1vms.android.jdbits.dtypes.BooleanType;
12+
import com.st1vms.android.jdbits.dtypes.DSerializable;
13+
import com.st1vms.android.jdbits.dtypes.DoubleType;
14+
import com.st1vms.android.jdbits.dtypes.Int8Type;
15+
import com.st1vms.android.jdbits.dtypes.UInt8Type;
16+
import com.st1vms.android.jdbits.dtypes.UTF8StringType;
17+
18+
import java.io.UnsupportedEncodingException;
19+
import java.util.ArrayList;
20+
import java.util.Locale;
21+
22+
public class MainActivity extends AppCompatActivity {
23+
24+
private String bytesToHexString(final byte[] bytes){
25+
StringBuilder sb = new StringBuilder();
26+
for(byte b : bytes){
27+
sb.append(String.format(Locale.getDefault(), "%02x", b));
28+
}
29+
return sb.toString();
30+
}
31+
32+
private static final String LOG_TAG = "LOG";
33+
34+
@Override
35+
protected void onCreate(Bundle savedInstanceState) {
36+
super.onCreate(savedInstanceState);
37+
setContentView(R.layout.activity_main);
38+
39+
// Packet registration
40+
// All packets must be registered before any de/serialization work
41+
DBits.RegisterPacket(0, new DTypes[]{
42+
DTypes.BOOLEAN_TYPE,
43+
DTypes.DOUBLE_TYPE,
44+
DTypes.UINT8_TYPE,
45+
DTypes.INT8_TYPE,
46+
DTypes.UTF8_STRING_TYPE
47+
});
48+
49+
UTF8StringType stringSerializable;
50+
try {
51+
stringSerializable = new UTF8StringType("I do desire we may be better strangers");
52+
}catch (UnsupportedEncodingException e){
53+
e.printStackTrace();
54+
return;
55+
}
56+
// A packet consists of an array of DSerializable
57+
// Each field has it's own DSerializable constructor
58+
final ArrayList<DSerializable> packet = new ArrayList<DSerializable>(0){
59+
{
60+
add(new BooleanType(true));
61+
add( new DoubleType(3.1415926));
62+
add(new UInt8Type((short)256));
63+
add(new Int8Type((byte)-128));
64+
add(stringSerializable);
65+
}
66+
};
67+
68+
// Perform serialization into a byte array
69+
final byte[] buffer = DBits.SerializeDPacket(new DPacket(0, packet));
70+
if(buffer == null){
71+
// Serialization error
72+
return;
73+
}
74+
75+
// Prints buffer
76+
Log.d(LOG_TAG, String.format("Serialized packet to -> %s",bytesToHexString(buffer)));
77+
78+
79+
// Deserialize buffer, reading no more than buffer.length bytes
80+
final DPacket resPacket = DBits.DeserializeBuffer(buffer, buffer.length);
81+
if(resPacket == null){
82+
// Deserialization error
83+
return;
84+
}
85+
86+
// Check packet id and field count
87+
if(resPacket.packet_id != 0 || resPacket.fieldCount() != 5){
88+
// Malformed packet
89+
return;
90+
}
91+
92+
BooleanType b = (BooleanType) resPacket.getField(0);
93+
DoubleType d = (DoubleType) resPacket.getField(1);
94+
UInt8Type u8 = (UInt8Type) resPacket.getField(2);
95+
Int8Type i8 = (Int8Type) resPacket.getField(3);
96+
UTF8StringType s = (UTF8StringType) resPacket.getField(4);
97+
// Extra null check
98+
if(null == b || null == d || null == u8 || null == i8 || null == s){
99+
return;
100+
}
101+
Log.d(LOG_TAG, String.format(Locale.getDefault(), "Packet boolean -> %b", b.getBoolValue()));
102+
Log.d(LOG_TAG, String.format(Locale.getDefault(), "Packet double -> %f",d.getDoubleValue()));
103+
Log.d(LOG_TAG, String.format(Locale.getDefault(), "Packet UINT8 -> %d", u8.getShortValue()));
104+
Log.d(LOG_TAG, String.format(Locale.getDefault(), "Packet INT8 -> %b", i8.getByteValue()));
105+
Log.d(LOG_TAG, String.format(Locale.getDefault(), "Packet String -> %s", s.getUTF8StringValue()));
106+
}
107+
}

‎examples/android-example/app/src/main/res/drawable-v24/ic_launcher_foreground.xml

+30
Original file line numberDiff line numberDiff line change
@@ -0,0 +1,30 @@
1+
<vector xmlns:android="http://schemas.android.com/apk/res/android"
2+
xmlns:aapt="http://schemas.android.com/aapt"
3+
android:width="108dp"
4+
android:height="108dp"
5+
android:viewportWidth="108"
6+
android:viewportHeight="108">
7+
<path android:pathData="M31,63.928c0,0 6.4,-11 12.1,-13.1c7.2,-2.6 26,-1.4 26,-1.4l38.1,38.1L107,108.928l-32,-1L31,63.928z">
8+
<aapt:attr name="android:fillColor">
9+
<gradient
10+
android:endX="85.84757"
11+
android:endY="92.4963"
12+
android:startX="42.9492"
13+
android:startY="49.59793"
14+
android:type="linear">
15+
<item
16+
android:color="#44000000"
17+
android:offset="0.0" />
18+
<item
19+
android:color="#00000000"
20+
android:offset="1.0" />
21+
</gradient>
22+
</aapt:attr>
23+
</path>
24+
<path
25+
android:fillColor="#FFFFFF"
26+
android:fillType="nonZero"
27+
android:pathData="M65.3,45.828l3.8,-6.6c0.2,-0.4 0.1,-0.9 -0.3,-1.1c-0.4,-0.2 -0.9,-0.1 -1.1,0.3l-3.9,6.7c-6.3,-2.8 -13.4,-2.8 -19.7,0l-3.9,-6.7c-0.2,-0.4 -0.7,-0.5 -1.1,-0.3C38.8,38.328 38.7,38.828 38.9,39.228l3.8,6.6C36.2,49.428 31.7,56.028 31,63.928h46C76.3,56.028 71.8,49.428 65.3,45.828zM43.4,57.328c-0.8,0 -1.5,-0.5 -1.8,-1.2c-0.3,-0.7 -0.1,-1.5 0.4,-2.1c0.5,-0.5 1.4,-0.7 2.1,-0.4c0.7,0.3 1.2,1 1.2,1.8C45.3,56.528 44.5,57.328 43.4,57.328L43.4,57.328zM64.6,57.328c-0.8,0 -1.5,-0.5 -1.8,-1.2s-0.1,-1.5 0.4,-2.1c0.5,-0.5 1.4,-0.7 2.1,-0.4c0.7,0.3 1.2,1 1.2,1.8C66.5,56.528 65.6,57.328 64.6,57.328L64.6,57.328z"
28+
android:strokeWidth="1"
29+
android:strokeColor="#00000000" />
30+
</vector>

0 commit comments

Comments
 (0)