carltonwhitehead / wifi-auto-forget Goto Github PK

Since it was easy to add a call to show a notification in this case, I added a TODO message to remind me to implement it. However, I see no need for a notification in this case, so I'm going to remove it.

Provide an option to show a notification when the device has joined a Never AutoForget Wi-Fi. This notification would be configurable on a per-Wi-Fi basis.

Some users might like to have their device call more attention when joining certain Never AutoForget Wi-Fis, such as a work guest network, etc.

The default value will be no notification. When changing a Wi-Fi's AutoForget Behavior, the notification enablement status will be preserved; if the user enables the notification on a Never AutoForget Wi-Fi, then switches its Behavior to Permanent AutoForget, then back to Never AutoForget, it will still be enabled. If the user instead leaves the notification enabled but leaves the Behavior on Permanent AutoForget, no notification will be shown, as such notifications will only be shown for Never AutoForget networks having the notifcation enabled.

I'd like to support back to Ice Cream Sandwich, however, I will only support versions which don't require too many workarounds, and testing on older Android versions will be very limited. There will absolutely never be support for Gingerbread in this app.

The About screen will display:

• The app name/icon
• A brief description of the functionality
• The author
• The license

From the About screen, the user will be able to navigate to the #10 Credits screen.

There has been some confusion among v0.1.0 alpha testers over the difference between Single and Permanent AutoForget Behavior.

As of v0.1.0, when the user joins an unknown (to Wi-Fi AutoForget, on the user's device) Wi-Fi network, three actions are available.

1. Swipe away the notification to assign Never AutoForget Behavior
2. Tap Single to assign Single AutoForget Behavior
3. Tap Permanent to assign Permanent AutoForget Behavior

Never

When the device eventually disconnects from the Wi-Fi, the app will take no action against the device's Wi-Fi configuration, nor against the app's internal list of known networks.

When the device comes in range again, the device's Wi-Fi service may automatically join it. When the device connects, no notification will be shown. (eventual possible exception when #8 implemented)

Use Cases: Trusted secure Wi-Fi networks, home wi-fi.

Single

When the device eventually disconnects from the Wi-Fi, the app will remove any system Wi-Fi configurations matching the SSID and then remove the SSID/Behavior paring from the app's internal list of known networks.

When the device comes in range again, the device's Wi-Fi service will not know the network, and the user must direct the device to join it. Once connected, the app will have no knowledge (due to the above described removal of the network from the app's internal list of known networks), and so will show the Unknown Wi-Fi notification.

In case the app never receives a disconnect event broadcast from the system (triggering the automatic removal), the app will not notify the user of reconnection; this might happen when moving around a large building with a single SSID covered by multiple access points.

Use Cases: ???

Permanent

When the device eventually disconnects from the Wi-Fi, the app will remove any system Wi-Fi configurations matching the SSID, but NOT remove the SSID/Behavior pairing from the app's internal list of known networks.

When the device comes in range again, the device's Wi-Fi service will not know the network, and the user must direct the device to join it. Once connected, the app will recognize it as a Permanent AutoForget network, and show no notification.

This will have the same behavior as Single in the case of the device jumping access points for the same SSID.

Use Cases: "guest", other awful but sadly common Wi-Fi networks that you would prefer to have to manually join each time.

The onboarding screen will familiarize new users with the functionality and vocabulary of the app.

• Explain Single/Permanent/Never AutoForget behavior terminology
• Explain AddWifiNotification
  • Swipe away notification for Never AutoForget behavior
  • Tap labeled actions for Single/Permanent AutoForget behavior

There is no documentation yet for the difference in behaviors, so for now, please refer to the source at https://github.com/carltonwhitehead/wifi-auto-forget/blob/master/Code/WifiAutoForget/src/main/java/com/cebesius/wifiautoforget/util/AutoForgetDelegate.java

I envision three entry points into the Onboarding screen:

• When the app first launches, the user will be directed to Onboarding
• If the user has not completed onboarding, when any Wi-Fi connectivity event (connect/disconnect), show a notification
• An Onboarding button in an overflow menu or Help screen (TBD)