KaiOS Reference

Setup

1. Download Firefox <= v59
2. Keep Firefox from updating with policies.json OR setting preferences to "never check for updates"
3. Install ADB

Debug Mode

Dial *#*#33284#*#* to enter debug mode. If this code dosn't work see other options depending on your device.

Manifest

The app manifest file describes the entrypoint and other information about your app to KaiOS.

App Icons

https://developer.kaiostech.com/design-guide/launcher-icon

"icons": {
  "56": "/img/ic_Appname_56.png",
  "112": "/img/ic_Appname_112.jpg"
}

Resizing with imagemagick

convert ic_Appname.png -resize 56x56\! ic_Appname_56.png
convert ic_Appname.png -resize 112x112\! ic_Appname_112.png

Borowserlist

Past this config into .browserlistrc in the project directory. Using bable requires @bable/preset-env

last 1 version
kaios

ADB

Install

OSX

Should be no configuration.

Linux

• Debian/Ubuntu based distors follow KaiOS Docs
• RPM & Arch based linux distros should follow instruction on the arch wiki
• Make sure you have installed adb, setup udev rules, and added user to the appropriate adb group.

List Devices

adb devices

Troubleshooting

Sometimes linux report no adb permisions on device. Try reseting the udev rules, and restarting the adb server

sudo udevadm control --reload-rules
sudo adb kill-server
sudo adb start-server
adb devices

Enter shell on device

adb shell

Get device stats

cat /proc/cpuinfo
cat /proc/meminfo
cat /proc/zoneinfo
free -m

Watch memory use

top -m 5 -s rss -d 1
pmap

Log system events

logcat is equivalent to journalctl -f (tailing logs)

from an adb shell run

logcat

Dump system services

Use dumpsys to dump running services

sysdump

Trace userspace process

Trace userspace process with atrace

atrace

adb over wifi

Connect to devices over wifi With device plugged in, set device to listen for TCP/IP connections on port 5555

adb tcpip 5555

Unplug device, and connect to device over network

adb connect <device ip>

Confirm device is connected

adb devices

Read more here

Keypad

Docs

• KaiOS Docs
• KaiOS Solutions
• Jio Docs
• Banana Hackers

Notes

• Google Assistant on feature phones

• zip package

zip -r package.zip src

• maybe not wasm but asm.js possible with emscripten https://zserge.com/posts/my-experience-with-asmjs/

Talks

• Google IO: Next Billion Users
• Google IO: Proxx Game
• Firefox OS is back. on KaiOS

Example App: Proxx

Proxx (by google)

Specs:

• Initial Payload < 25k
• Time to interactive < 5 sec on slow 3G
• 60 fps
• Preact
• Comlink
• Accessiblity with tabindex (checkout https://web.dev/accessible/)
• Number keys in UX
• Travis size report

Devices

• Low End: MTN Smart S
• High End: Nokia 8110
• Device List
• MTN phones
• KaiOS USA prepaid phones

Permission Table

• MTN Smart

Release Calendar

Mozilla will be supporting KaiOS begining with Firefox ESR (Extend Support Release) 78, scheduled for realease on June 30th 2020.