NavCogAndroid

Android version of example application "NavCog".

About

About HULOP

License

MIT

Prerequisites

Android Studio and Android SDK (Android 13 SDK 33 or later)
CocoaPods (1.6.1 or later)
cmake (3.15.2 or later)

Dependent libraries

HULOP blelocpp (MIT License)
OpenCV (OpenCV-Dynamic) 4.0.1 (BSD License)

About libopencv_java4.so

Please put libopencv_java4.so from Android pack OpenCV-android-sdk (under /sdk/native/libs folder) into folders below:

/app/src/main/jniLibs/arm64-v8a
/app/src/main/jniLibs/armeabi-v7a
/app/src/main/jniLibs/x86_64

OpenCV-android-sdk can be found at https://opencv.org/releases/.

(Currently, HULOP uses version 4.0.1. If needed, please use an appropriate version of so file.)

How to build

Install CocoaPods (If you have not installed)

Install and update Homebrew
$brew install python
$pip install mercurial
Install CocoaPods

Install cmake (version 3.15.2)

$brew instal cmake

Build bleloc Framework for Android

Follow instructions of blelocpp

If you want to build Android version only, you don't need to do the final step ($sh build.sh Release).

If OpenCV-Dynamic4.0.1 can't install well. Please try to use Homebrew as below.
1. $brew install opencv
2. $cd blelocpp/platform/ios
3. Comment out the line below from Podfile.
```
pod 'OpenCV-Dynamic', '4.0.1'
```
4. $pod install
5. Modify NavCogAndroid/app/CMakeLists.txt to include OpenCV as below.
```
# Use OpenCV via Homebrew
include_directories(/usr/local/opt/opencv/include/opencv4)
```
6. Go to Build step. (Step 3 below is not required.)

If Pods/Headers/Public/OpenCV-Dynamic does not exist, copy header files into Pods/Headers/Public/OpenCV-Dynamic.

cd blelocpp/platform/ios
mkdir -p Pods/Headers/Public/OpenCV-Dynamic/opencv2
cp -R Pods/OpenCV-Dynamic/opencv2.framework/Headers/ Pods/Headers/Public/OpenCV-Dynamic/opencv2

Build

Build the example app by using Android Studio.

How to use local serverlist file for test.

Enable adb shell

Install adb with Android Studio, and then add PATH for it. (For example, add line below into ~/.bashrc)
```
export PATH=$PATH:$HOME/Library/Android/sdk/platform-tools
```

Find target folder in the Android device.

Connect target Android device with Mac, and then start adb shell
Find target folder (/storage/self/primary/Android/data/hulop.navcog/files is the default.)
After confirm the target folder, exit from adb.

Copy serverlist file(serverlist.txt or serverlist.json) into the target folder as below.

adb push serverlist.[txt|json] /storage/self/primary/Android/data/hulop.navcog/files

Troubleshooting

build fail related to blelocpp

Please try one of steps below, and try build again.

Delete blelocpp/platform/ios/Pods, and then pod install
Build→Clean Project, Build→Refresh Linked C++ Projects in Android Studio.

hulop/NavCogAndroid