~grauwoelfchen/nowt

#Nowt

/naʊt/

An immersive RSS reader for Android.

You can do nowt (nought) except reading an item/entry at a time.

#Requirements

Android 13 (API Level 33, Tiramisu)
SDK Build Tools 34
SDK Platform Tools 34
OpenJDK 17
Gradle 8.10.2

#Required permissions

INTERNET
ACCESS_NETWORK_STATE

#Build

% make build

#LICENSE

GPL-3.0-or-later

See LICENSE.

Nowt
Copyright (C) 2023-2024 Yasha

This program is free software: you can redistribute it and/or modify
it under the terms of the GNU General Public License as published by
the Free Software Foundation, either version 3 of the License, or
(at your option) any later version.

This program is distributed in the hope that it will be useful,
but WITHOUT ANY WARRANTY; without even the implied warranty of
MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.  See the
GNU General Public License for more details.

You should have received a copy of the GNU General Public License
along with this program.  If not, see <https://www.gnu.org/licenses/>.

#Notes

#Development

#Java and Gradle

% eselect java-vm list
Available Java Virtual Machines:
  [1]   openjdk-21
  [2]   openjdk-bin-17  system-vm user-vm
  [3]   openjdk-bin-21

% java --version
openjdk 17.0.13 2024-10-15
OpenJDK Runtime Environment Temurin-17.0.13+11 (build 17.0.13+11)
OpenJDK 64-Bit Server VM Temurin-17.0.13+11 (build 17.0.13+11, mixed mode, sharing)

% eselect gradle list
Available gradle symlink targets:
  [1]   gradle-bin-8.10.2 *
  [2]   gradle-bin-8.4
  [3]   gradle-bin-8.7

% gradle --version

------------------------------------------------------------
Gradle 8.10.2
------------------------------------------------------------

Build time:    2024-09-23 21:28:39 UTC
Revision:      415adb9e06a516c44b391edff552fd42139443f7

Kotlin:        1.9.24
Groovy:        3.0.22
Ant:           Apache Ant(TM) version 1.10.14 compiled on August 16 2023
Launcher JVM:  17.0.13 (Eclipse Adoptium 17.0.13+11)
Daemon JVM:    /opt/openjdk-bin-17.0.13_p11 (no JDK specified, using current Java home)
OS:            Linux 6.11.5-gentoo-dist amd64

#Setup Emulator

Setup QEMU/KVM
- Configure CPU virtualization by enabling AMD-V (svm) or Vt-x (vmx) in UEFI firmware or BIOS
  - Check support of the system's firhmware with grep -E "svm|vmx" /proc/cpuinfo
  - Check /dev/kvm is listed
- VM acceleration
  - See Configure VM acceleration
  - e.g. on Gentoo Linux
    - app-emulation/qemu
    - libvirt
    - net-misc/bridge-utils
Create a virtual device
Install Android SDK Command-line Tools
- Configure ANDROID_HOME (e.g. as $HOME/.android or /opt/... etc.)
Run ./bin/run-emulator script
See the doc: Start the emulator from the command line
(optional) Check/Edit hardware acceleration settings
- Run with run-emulator xxx -gpu swiftshader_indirect etc.
- To disable via config.ini
  - Find config.ini for AVDs
  - Disable hardware GPU use as followings

% find ~/.android -name "config.ini"
/path/to/$ANDROID_HOME/avd/XXX.avd/config.ini

config.ini:

# default
# hw.gpu.enabled = yes
# hw.gpu.mode = auto
hw.gpu.enabled = no
hw.gpu.mode = off

#Setup udev rules for USB debugging

e.g. for my Cat S52 ;)

Add an user in plugdev group.

% sudo usermod -aG plugdev <user>

Create an udev rule.

# Check IDs
% lsusb | grep S52
Bus 007 Device 011: ID 04b7:88e0 Compal Electronics, Inc. S52

% cat /etc/udev/rules.d/51-android.rules
# Cat S52
SUBSYSTEMS=="usb", ATTRS{idVendor}=="04b7", ATTRS{idProduct}=="88e0", \
  MODE="0600", GROUP="plugdev", SYMLINK+="android%n"
% sudo udevadm control --reload-rules

After the device is connected, I can see it.

% ls -la /dev/android3
lrwxrwxrwx 1 root root 15 Jan 30 02:18 /dev/android3 -> bus/usb/007/011

In order to make it available on USB debugging via adb, go Settings -> Developer options -> Default USB configuration, then set it as File transfer mode.

Then,

% adb start-server
...
% adb devices -l
List of devices attached
S522003011998          device usb:7-6.3 product:CatS52 model:S52 device:CatS52 transport_id:1

refs

clone