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

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.

  • https://firefly.adobe.com/
  • https://app.leonardo.ai/image-generation

• 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

# For all platforms
rm -rf node_modules
npm install

# For android
rm -rf android/app/.cxx
(cd android && ./gradlew clean)

# For iOS
rm -rf ~/Library/Caches/CocoaPods
rm -rf ios/Pods
rm -rf ios/Podfile.lock
rm -rf ios/build
(cd ios && RCT_NEW_ARCH_ENABLED=1 pod install)

# For all platforms
watchman watch-del .
watchman watch-project .
npm start -- --reset-cache

"Unable to boot simulator" error for iOS Simulator

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

https://github.com/shinydevelopment/SimulatorStatusMagic

Some troubleshooting links

React Native Troubleshooting page.