Ham2K Portable Logger - PoLo

The fastest, easiest, bestest way to log your amateur radio operations on the go.

Our Community

• Forums - Please use our forums to report bugs, suggestions and issues in general.

• Discord - Come here for casual discussions, development help and to share your operation photos and videos.

• Instagram - Photos and Videos of Ham2K apps in use out in the real world.

• Documentation - Read The Fine Manual

Install Links

Official Releases

• Android - Google Play
• iOS - AppStore

Test Releases

• Android - Beta Testing via Google Play testing
• iOS - Beta Testing via TestFlight

This app is Open Source and licensed under the Mozilla Public License 2.0

---

Notes for Developers

Development Environment

First, complete the React Native - Environment Setup instructions.

Then clone this repository, cd into it and install the dependencies:

npm install
# you might need to also run `npm install redux-persist` if you get errors about missing modules

Maps

In order to use Mapbox maps in your local builds, you need to:

1. Signup for a Mapbox account
2. Create an access token with downloads:read scope
3. Save the access token to .env as MAPBOX_ACCESS_TOKEN

Build

And finally, build the app for your target platform:

# iOS
(cd ios && pod install)
npm run ios

# Android
npm run android

Debug Menu

iOS: Cmd ⌘ + D

Android: Cmd ⌘ + M (macOS) or Ctrl + M (Windows and Linux)

Resources

Icons from https://pictogrammers.com/library/mdi/

Tools

• https://icon.kitchen/

Access iOS Simulator Info

https://www.iosdev.recipes/simctl/

xcrun simctl
xcrun simctl listapps booted # List all apps

Local path for PoLo's internal files

open `xcrun simctl get_app_container booted com.ham2k.polo data`/Documents

Local path where files are saved when exporting and "Save To Files"

open `xcrun simctl get_app_container booted com.apple.DocumentsApp groups |grep FileProvider.LocalStorage|sed "s/group.com.apple.FileProvider.LocalStorage//g"`/File\ Provider\ Storage

Updating the splash screen

• Start with a 2048x2048 image.
• Go to AppIcon > Image Sets, upload the image, generate and download the image set
• On android/app/src/main/res replace launch_screen in each subdirectory.
• On ios/polo/Images.xcassets/LaunchScreen.imageset replace the three versions of launch_screen
• On src/screens/StartScreen/img replace the three versions of launch_screen.

---

Known Issues

Troubleshooting

Clean Build

npm run clean:js  # wipe node_modules and reinstall
npm run clean:android  # wipe android build and gradle caches
npm run clean:ios  # wipe ios build and cocoapods caches, reinstall pods
npm run clean:watchman  # wipe watchman caches

# or

npm run clean:all  # wipe all caches and reinstall

# and then

npm start -- --reset-cache
npm run ios
npm run android

"Unable to boot simulator" error for iOS Simulator

• Go to [About this Mac > Storage > Manage > Developer]
• Delete XCode caches

https://github.com/shinydevelopment/SimulatorStatusMagic

"unable to resolve module redux-persist/integration/react"

For some reason, sometimes the redux-persist does not install correctly the first time, so you need to run npm install redux-persist manually.

Some troubleshooting links

React Native Troubleshooting page.