merging from main

Author: AR Abdul Azeez

.gitignore

@@ -1,35 +1,37 @@
-# See https://help.github.com/articles/ignoring-files for more about ignoring files.
-#
-# If you find yourself ignoring temporary files generated by your text editor
-# or operating system, you probably want to add a global ignore instead:
-#   git config --global core.excludesfile '~/.gitignore_global'
+# Gradle
+.gradle/
+build/
+*/build/
 
+# Local properties
+local.properties
+OneSignalSDK/local.properties
+Examples/OneSignalDemo/local.properties
 
-# Ignore all logfiles and tempfiles.
-/log/*.log
-/tmp
+# macOS
+.DS_Store
 
-# built application files
-*.apk
-*.ap_
-
-# files for the dex VM
-*.dex
+# IDE files
+.idea/
+*.iml
 
-# Java class files
-*.class
+# Captures
+captures/
+OneSignalSDK/captures/
+Examples/OneSignalDemo/captures/
 
-# generated files
-bin/
-gen/
+# GPG files
+*.gpg
 
-# Proguard folder generated by Eclipse
-proguard/
+# Misc
+*.log
+*.tmp
+*.swp
+*.swo
 
-# Examples
+# Node modules (if using JS tooling)
+node_modules/
 
-.idea/
-Examples/.idea/
-Examples/AndroidStudio/
-Examples/OneSignalDemo/app/build/
-OneSignalSDK/app/build/
+# Android Studio
+*.apk
+*.ap_

Examples/OneSignalDemo/.idea/vcs.xml

@@ -14,6 +14,10 @@ object OneSignalUtils {
         formatVersion(BuildConfig.SDK_VERSION)
     }
 
+    /**
+     * Formats a version string to ensure proper lexicographical sorting.
+     * For example, "1.2.3-beta" becomes "010203-beta", "1.20.3" becomes "010203".
+     */
     internal fun formatVersion(version: String): String {
         val parts = version.split("-", limit = 2)
         val base = parts[0].split(".")

Examples/OneSignalDemo/app/app.iml

@@ -3,7 +3,11 @@
 gradle.rootProject {
     allprojects {
         group = 'com.onesignal'
-        version = gradle.rootProject.hasProperty("SDK_VERSION") ? gradle.rootProject.getProperty("SDK_VERSION") : "x.x.x"
+        if (!gradle.rootProject.hasProperty("SDK_VERSION") ||
+                gradle.rootProject.getProperty("SDK_VERSION").toString().trim().isEmpty()) {
+            throw new RuntimeException("SDK_VERSION is not defined. Please pass -PSDK_VERSION=X.Y.Z to the build or update gradle.properties.")
+        }
+        version = gradle.rootProject.getProperty("SDK_VERSION")
         configurations.all {
             resolutionStrategy.dependencySubstitution {
                 substitute(module('com.onesignal:OneSignal')).using(project(':OneSignal'))