apply consistent formatting style

Author: VREMSoftwareDevelopment

.editorconfig

@@ -0,0 +1,52 @@
+# Coding Conventions style guide
+root = true
+
+[*]
+indent_style = space
+indent_size = 4
+tab_width = 4
+continuation_indent_size = 4
+insert_final_newline = true
+charset = utf-8
+trim_trailing_whitespace = true
+max_line_length = 120
+end_of_line = lf
+
+[*.{kt,kts}]
+indent_size = 4
+continuation_indent_size = 4
+insert_final_newline = true
+max_line_length = 120
+
+[*.java]
+indent_size = 4
+continuation_indent_size = 4
+max_line_length = 120
+
+[*.gradle]
+indent_size = 4
+
+[*.xml]
+indent_size = 4
+
+[*.md]
+indent_size = 2
+trim_trailing_whitespace = false
+insert_final_newline = true
+charset = utf-8
+
+[*.properties]
+charset = utf-8
+end_of_line = lf
+insert_final_newline = true
+trim_trailing_whitespace = true
+
+[*.json]
+indent_size = 2
+insert_final_newline = true
+charset = utf-8
+
+[*.{yml,yaml}]
+indent_size = 2
+insert_final_newline = true
+charset = utf-8

.github/workflows/android_ci.yml

@@ -7,11 +7,22 @@ jobs:
     steps:
       - name: checkout repository
         uses: actions/checkout@v4
+      - name: Cache Gradle packages
+        uses: actions/cache@v4
+        with:
+          path: |
+            ~/.gradle/caches
+            ~/.gradle/wrapper
+          key: gradle-${{ runner.os }}-${{ hashFiles('**/*.gradle*', '**/gradle-wrapper.properties') }}
+          restore-keys: |
+            gradle-${{ runner.os }}-
       - name: set up JDK 21
         uses: actions/setup-java@v4
         with:
           distribution: 'zulu'
           java-version: '21'
+      - name: ktlint check
+        run: bash ./gradlew ktlintCheck --stacktrace
       - name: lint
         run: bash ./gradlew lintDebug --stacktrace
       - name: unit tests

README.md

@@ -30,7 +30,7 @@ This is the official repository of WiFiAnalyzer.
 * Analyze Wi-Fi networks to rate channels
 * HT/VHT Detection - 40/80/160/320 MHz (Requires hardware/software support)
 * 2.4 GHz, 5 GHz and 6 GHz Wi-Fi bands (Requires hardware/software support)
-* Access Point view complete or compact
+* Access Point view: complete or compact
 * Estimated Distance to the Access Points
 * Export access points details
 * Dark, Light and System theme available
@@ -59,7 +59,7 @@ The complete guide to using WiFiAnalyzer can be found in the [User Manual](USER_
 * [Android Wi-Fi scanning throttling](https://github.com/VREMSoftwareDevelopment/WiFiAnalyzer/wiki/Android-WiFi-scanning-throttling)
 * [Location Service Permission Requirements](https://github.com/VREMSoftwareDevelopment/WiFiAnalyzer/wiki/Location-Service-Permission-Requirements)
 * [WiFiAnalyzer on secondary user accounts](https://github.com/VREMSoftwareDevelopment/WiFiAnalyzer/wiki/WiFi-Analyzer-on-secondary-user-accounts)
-* [How channel graph displays 20/40/80/160/320 MHz channel width?](https://github.com/VREMSoftwareDevelopment/WiFiAnalyzer/issues/64)
+* [How does the channel graph display...](https://github.com/VREMSoftwareDevelopment/WiFiAnalyzer/issues/64)
 * [How to use SSID filter?](https://github.com/VREMSoftwareDevelopment/WiFiAnalyzer/issues/125)
 * [WiFiAnalyzer equivalent on iOS](https://github.com/VREMSoftwareDevelopment/WiFiAnalyzer/issues/69)
 
@@ -68,7 +68,6 @@ The complete guide to using WiFiAnalyzer can be found in the [User Manual](USER_
 * Bug reports can be submitted [here](https://github.com/VREMSoftwareDevelopment/WiFiAnalyzer/issues).
 * To learn how to submit a bug [click here](https://github.com/VREMSoftwareDevelopment/WiFiAnalyzer/wiki/Feedback).
 * [Discussions](https://github.com/VREMSoftwareDevelopment/WiFiAnalyzer/discussions)
-* If you do not have GitHub account, please use [google groups](https://groups.google.com/forum/#!forum/wifi-analyzer-open-source) to discuss application features.
 
 ## License
 
@@ -90,9 +89,9 @@ WiFiAnalyzer is licensed under the GNU General Public License v3.0 (GPLv3).
 ## Privacy policy
 
 * WiFiAnalyzer does not collect any personal/device information.
-* WiFiAnalyzer is designed to use as few permissions as possible. It asks for just enough to perform the analysis. 
-* Plus, it is all open source so nothing is hidden! 
-* Most notably, this application does not require access to internet, so you can be sure it does not send any personal/device information to any other source and it does not receive any information from other sources. 
+* WiFiAnalyzer is designed to use as few permissions as possible. It asks for just enough to perform the analysis.
+* Plus, it is all open source so nothing is hidden!
+* Most notably, this application does not require access to the internet, so you can be sure it does not send any personal/device information to any other source and it does not receive any information from other sources.
 
 ## WiFiAnalyzer Build
 
@@ -116,28 +115,53 @@ WiFiAnalyzer is licensed under the GNU General Public License v3.0 (GPLv3).
 ## Contribute
 
 * Want to contribute? Check out our [CONTRIBUTING.md](CONTRIBUTING.md) to see how you can help.
-* We want to express our gratitude to all [people](https://github.com/VREMSoftwareDevelopment/WiFiAnalyzer/graphs/contributors) for their contributions, such as: patches, bug solving, updates and etc.
-* If you would like to contribute financially to the project please feel free to send any amount through paypal.
+* We want to express our gratitude to all [contributors](https://github.com/VREMSoftwareDevelopment/WiFiAnalyzer/graphs/contributors) for their contributions, such as patches, bug fixes, updates, and more.
+* If you would like to contribute financially to the project, please feel free to send any amount through PayPal.
     * [![](https://www.paypalobjects.com/en_US/i/btn/btn_donateCC_LG.gif)](https://www.paypal.com/cgi-bin/webscr?cmd=_s-xclick&hosted_button_id=62PA6HJ3BZL3E)
-    * Thanks to every one who already donated so far!
+    * Thanks to everyone who has already donated!
 
-### Build project
+## Build project
 
 1. Install Android Studio
-2. Import project into Android Studio
-    * In Welcome to Android Studio Screen select Import project ...
+2. Import the project into Android Studio
+    * In the Welcome to Android Studio screen, select "Import project ..."
     * Select the root directory of the WiFiAnalyzer repository and click "OK".
     * WiFiAnalyzer will build automatically.
 
-### Running lint, unit tests and jacoco coverage report
+## Running various Gradle commands
 
-```
-./gradlew lintDebug jacocoTestCoverageVerification
-```
+### Check Kotlin code style
+`./gradlew ktlintCheck`
 
-- lint report: `app/build/reports/lint-results.html`
-- unit test report: `app/build/reports/tests/testDebugUnitTest/index.html`
-- code coverage report: `app/build/reports/jacoco/jacocoTestReport/html/index.html`
+### Apply Kotlin code style
+`./gradlew ktlintFormat`
+
+### Run lint analysis
+`./gradlew lintDebug`
+
+This command generates the following report:
+- Lint report: `app/build/reports/lint-results.html`
+
+### Run unit tests with coverage
+`./gradlew testDebugUnitTest`
+
+This command generates the following report:
+- Unit test report: `app/build/reports/tests/testDebugUnitTest/index.html`
+
+### Run unit tests with coverage
+`./gradlew jacocoTestCoverageVerification`
+
+This command generates the following report:
+- Code coverage report: `app/build/reports/jacoco/jacocoTestReport/html/index.html`
+
+## Continuous Integration
+
+This project uses GitHub Actions for CI/CD. On every push and pull request, the following checks are performed automatically:
+- Code style check with ktlint
+- Lint analysis
+- Unit tests with coverage (uploaded to Codecov)
+- APK build (debug)
+- Artifacts (reports and APK) are available for download in the workflow run
 
 ## Translation
 

app/build.gradle

@@ -21,6 +21,7 @@ plugins {
     id "kotlin-android"
     id "kotlin-allopen"
     id "jacoco"
+    id "org.jlleitschuh.gradle.ktlint" version "13.0.0"
 }
 
 apply {

app/build.properties

@@ -1,6 +1,6 @@
 #Build Properties
-#Sat Jul 26 09:17:15 EDT 2025
-version_build=23
+#Mon Jul 28 09:54:51 EDT 2025
+version_build=24
 version_major=3
 version_minor=2
 version_patch=1

app/src/androidTest/kotlin/com/vrem/wifianalyzer/InstrumentedTestUtils.kt

@@ -29,7 +29,10 @@ import org.hamcrest.TypeSafeMatcher
 private const val SLEEP_1_SECOND = 1000
 private const val SLEEP_3_SECONDS = 3000
 
-internal class ChildAtPosition(val parentMatcher: Matcher<View>, val position: Int) : TypeSafeMatcher<View>() {
+internal class ChildAtPosition(
+    val parentMatcher: Matcher<View>,
+    val position: Int,
+) : TypeSafeMatcher<View>() {
     override fun describeTo(description: Description) {
         description.appendText("Child at position $position in parent ")
         parentMatcher.describeTo(description)
@@ -41,22 +44,19 @@ internal class ChildAtPosition(val parentMatcher: Matcher<View>, val position: I
     }
 }
 
-internal fun withToolbarTitle(expectedTitle: CharSequence): Matcher<View> {
-    return object : BoundedMatcher<View, Toolbar>(Toolbar::class.java) {
+internal fun withToolbarTitle(expectedTitle: CharSequence): Matcher<View> =
+    object : BoundedMatcher<View, Toolbar>(Toolbar::class.java) {
         override fun describeTo(description: Description) {
             description.appendText("with toolbar title: $expectedTitle")
         }
 
-        override fun matchesSafely(toolbar: Toolbar): Boolean =
-            toolbar.title == expectedTitle
+        override fun matchesSafely(toolbar: Toolbar): Boolean = toolbar.title == expectedTitle
     }
-}
 
 internal fun pressBackButton() = pressBack()
 
 internal fun pauseShort() = pause(SLEEP_1_SECOND)
 
 internal fun pauseLong() = pause(SLEEP_3_SECONDS)
 
-private fun pause(sleepTime: Int) =
-    runCatching { Thread.sleep(sleepTime.toLong()) }.getOrElse{ it.printStackTrace() }
+private fun pause(sleepTime: Int) = runCatching { Thread.sleep(sleepTime.toLong()) }.getOrElse { it.printStackTrace() }

app/src/androidTest/kotlin/com/vrem/wifianalyzer/MainInstrumentedTest.kt

@@ -29,17 +29,17 @@ import org.junit.runner.RunWith
 @LargeTest
 @RunWith(AndroidJUnit4::class)
 class MainInstrumentedTest {
-
     @get:Rule
     val activityTestRule: ActivityScenarioRule<MainActivity> = activityScenarioRule()
 
     @get:Rule
-    val grantPermissionRule: GrantPermissionRule = GrantPermissionRule.grant(
-        android.Manifest.permission.ACCESS_COARSE_LOCATION,
-        android.Manifest.permission.ACCESS_FINE_LOCATION,
-        android.Manifest.permission.ACCESS_WIFI_STATE,
-        android.Manifest.permission.CHANGE_WIFI_STATE
-    )
+    val grantPermissionRule: GrantPermissionRule =
+        GrantPermissionRule.grant(
+            android.Manifest.permission.ACCESS_COARSE_LOCATION,
+            android.Manifest.permission.ACCESS_FINE_LOCATION,
+            android.Manifest.permission.ACCESS_WIFI_STATE,
+            android.Manifest.permission.CHANGE_WIFI_STATE,
+        )
 
     @Test
     fun navigation() {
@@ -55,4 +55,4 @@ class MainInstrumentedTest {
     fun filter() {
         FilterInstrumentedTest().run()
     }
-}
+}

app/src/androidTest/kotlin/com/vrem/wifianalyzer/NavigationInstrumentedTest.kt

@@ -21,7 +21,11 @@ import androidx.appcompat.widget.Toolbar
 import androidx.test.espresso.Espresso.onView
 import androidx.test.espresso.action.ViewActions.click
 import androidx.test.espresso.assertion.ViewAssertions.matches
-import androidx.test.espresso.matcher.ViewMatchers.*
+import androidx.test.espresso.matcher.ViewMatchers.isAssignableFrom
+import androidx.test.espresso.matcher.ViewMatchers.isDisplayed
+import androidx.test.espresso.matcher.ViewMatchers.withClassName
+import androidx.test.espresso.matcher.ViewMatchers.withContentDescription
+import androidx.test.espresso.matcher.ViewMatchers.withId
 import org.hamcrest.Matchers
 import org.hamcrest.Matchers.allOf
 
@@ -30,28 +34,30 @@ private const val NAVIGATION_DRAWER_ACTION = 1
 private const val NAVIGATION_DRAWER_TAG = "Open navigation drawer"
 
 internal class NavigationInstrumentedTest : Runnable {
-
     override fun run() {
         listOf(
             2 to "Channel Rating",
             3 to "Channel Graph",
             4 to "Time Graph",
             1 to "Access Points",
             7 to "Available Channels",
-            8 to "Vendors"
+            8 to "Vendors",
         ).forEach { (id, title) ->
             selectMenuItem(id, title)
         }
         listOf(
             10 to "Settings",
-            11 to "About"
+            11 to "About",
         ).forEach { (id, title) ->
             selectMenuItem(id, title)
             pressBackButton()
         }
     }
 
-    private fun selectMenuItem(menuItem: Int, expectedTitle: String) {
+    private fun selectMenuItem(
+        menuItem: Int,
+        expectedTitle: String,
+    ) {
         onView(
             allOf(
                 withContentDescription(NAVIGATION_DRAWER_TAG),
@@ -60,28 +66,28 @@ internal class NavigationInstrumentedTest : Runnable {
                         withId(R.id.toolbar),
                         ChildAtPosition(
                             withClassName(Matchers.`is`("com.google.android.material.appbar.AppBarLayout")),
-                            NAVIGATION_DRAWER_BUTTON
-                        )
+                            NAVIGATION_DRAWER_BUTTON,
+                        ),
                     ),
-                    NAVIGATION_DRAWER_ACTION
+                    NAVIGATION_DRAWER_ACTION,
                 ),
-                isDisplayed()
-            )
+                isDisplayed(),
+            ),
         ).check(matches(isDisplayed())).perform(click())
 
         onView(
             allOf(
                 ChildAtPosition(
                     allOf(
                         withId(com.google.android.material.R.id.design_navigation_view),
-                        ChildAtPosition(withId(R.id.nav_drawer), NAVIGATION_DRAWER_BUTTON)
-                    ), menuItem
+                        ChildAtPosition(withId(R.id.nav_drawer), NAVIGATION_DRAWER_BUTTON),
+                    ),
+                    menuItem,
                 ),
-                isDisplayed()
-            )
+                isDisplayed(),
+            ),
         ).check(matches(isDisplayed())).perform(click())
 
         onView(isAssignableFrom(Toolbar::class.java)).check(matches(withToolbarTitle(expectedTitle)))
     }
-
-}
+}

app/src/androidTest/kotlin/com/vrem/wifianalyzer/ScannerInstrumentedTest.kt

@@ -19,18 +19,18 @@ package com.vrem.wifianalyzer
 
 import androidx.test.espresso.Espresso.onView
 import androidx.test.espresso.action.ViewActions.click
-import androidx.test.espresso.matcher.ViewMatchers.*
+import androidx.test.espresso.matcher.ViewMatchers.isDisplayed
+import androidx.test.espresso.matcher.ViewMatchers.withContentDescription
+import androidx.test.espresso.matcher.ViewMatchers.withId
 import com.vrem.wifianalyzer.R.id.action_scanner
 import org.hamcrest.Matchers.allOf
 
 private const val PAUSE = "Pause"
 private const val PLAY = "Play"
 
 internal class ScannerInstrumentedTest : Runnable {
-
     override fun run() {
         onView(allOf(withId(action_scanner), withContentDescription(PAUSE), isDisplayed())).perform(click())
         onView(allOf(withId(action_scanner), withContentDescription(PLAY), isDisplayed())).perform(click())
     }
-
-}
+}

app/src/main/kotlin/com/vrem/util/CompatUtils.kt

@@ -45,8 +45,7 @@ fun Context.packageInfo(): PackageInfo =
 private fun Context.packageInfoAndroidT(): PackageInfo =
     packageManager.getPackageInfo(packageName, PackageInfoFlags.of(0))
 
-private fun Context.packageInfoLegacy(): PackageInfo =
-    packageManager.getPackageInfo(packageName, 0)
+private fun Context.packageInfoLegacy(): PackageInfo = packageManager.getPackageInfo(packageName, 0)
 
 fun ScanResult.ssid(): String =
     if (buildMinVersionT()) {