Android Helper Documentation

📦 التثبيت والإعداد (Installation)

📦 androidhelper setup & Android Helper.initialize(this)

Kotlin

أضف التبعية الخاصة بالمكتبة ثم قم بتهيئتها داخل Application class.

[versions] androidhelper = "1.5.0-beta04"

[libraries] androidhelper = { group = "com.github.zaitxcode", name = "androidhelper", version.ref = "androidhelper" }

import com.zaitxcode.android.Android Helper

Android Helper.initialize(this)

🌐 الشبكة والاتصال (Network)

🌐 Network.isConnected, activeTransport, isWifiConnected & getIpAddress

Kotlin

التحقق من حالة الاتصال بالإنترنت والاتصال المزدوج والإنترنت المؤكد وعنوان الـ IP عبر كلاس Network.

import com.zaitxcode.android.net.Network

val isOnline: Boolean = Network.isConnected

val isValidated: Boolean = Network.hasValidatedInternet()

val isMetered: Boolean = Network.isConnectionMetered()

val transport: String = Network.activeTransport()

val isWifi: Boolean = Network.isWifiConnected()

val isCellular: Boolean = Network.isCellularConnected()

val ipAddress: String? = Network.getIpAddress()

🔗 المقاصد والأفعال الخارجية (Intents)

🔗 Intent.openWhatsApp, dial, sendSms, sendEmail, shareFile, openMap, Browser.openUrl

Kotlin

فتح الروابط، محادثات الواتساب، الاتصال المباشر، إرسال البريد الإلكتروني، الخرائط، إعدادات التطبيق ومتجر بلاي فورياً عبر كلاسات Intent و Browser.

import com.zaitxcode.android.content.Intent

import com.zaitxcode.android.browser.Browser

Browser.openUrl("https://docs.zaitxcode.com/androidhelper")

Intent.openWhatsApp("201234567890", "Hello")

Intent.dial("201234567890")

Intent.sendSms("201234567890", "Test message")

Intent.sendEmail("info@example.com", "Subject", "Body")

Intent.shareText("Text to share")

Intent.openMap(30.0444, 31.2357, "Cairo")

Intent.openAppSettings()

Intent.openPlayStore()

🔊 الصوتيات وقياسات الشاشة

🔊 Audio.playClickSound, isMuted, getMusicVolume & Display Metrics

Kotlin

تشغيل صوت النقر للنظام، استعلام وضع الصوت ونسبة الارتفاع، اتجاه الشاشة وأبعادها بالـ dp عبر كلاسات Audio و Display.

import com.zaitxcode.android.hardware.Audio

import com.zaitxcode.android.hardware.Display

Audio.playClickSound()

val muted: Boolean = Audio.isMuted()

val volumePercent: Int = Audio.getMusicVolume()

val isPortrait: Boolean = Display.isPortrait()

val isLandscape: Boolean = Display.isLandscape()

val widthDp: Int = Display.getScreenWidthDp()

val heightDp: Int = Display.getScreenHeightDp()

📋 الحافظة والاهتزاز وحظر الشاشة

📋 Clipboard.copyText, getText, hasCopiedText & Vibration.vibrate & Screen.blockCapture

Kotlin

تشغيل الاهتزاز الفعلي، النسخ وقراءة مسح الحافظة، وحظر التقاط الشاشة عبر كلاسات Clipboard و Vibration و Screen.

Clipboard.copyText("Copied text")

val text: String? = Clipboard.getText()

val hasText: Boolean = Clipboard.hasCopiedText()

Clipboard.clear()

Vibration.vibrate(200)

Vibration.vibratePattern(longArrayOf(0, 100, 50, 200), -1)

Vibration.cancel()

Screen.blockCapture()

Screen.unblockCapture()

val blocked: Boolean = Screen.isCaptureBlocked()

🔔 الإشعارات ولوحة المفاتيح

🔔 Notification.showNotification, createChannel, cancelAll & Keyboard.hideKeyboard

Kotlin

إنشاء وإلغاء قنوات الإشعارات وعرض إشعارات مخصصة، وإخفاء وإظهار لوحة المفاتيح عبر كلاسات Notification و Keyboard.

Notification.createChannel("demo", "Demo Channel")

Notification.showNotification("demo", "Android Helper", "Hello", R.drawable.ic_launcher)

Notification.cancelAll()

val canPost: Boolean = Notification.canPostNotifications()

Keyboard.hideKeyboard()

📱 معلومات الجهاز والبطارية والتطبيق

📱 Device, Battery, AppInfo & AppState Metrics

Kotlin

استعلام تفاصيل اسم وموديل الجهاز، مستوى وصحة البطارية، حالة التطبيق في الواجهة أو الخلفية والصلاحيات عبر كلاسات Device و Battery و AppInfo و AppState.

val device: String = Device.deviceName()

val sdkLevel: Int = Device.sdk()

val isEmulator: Boolean = Device.isEmulator()

val batteryLevel: Int = Battery.getBatteryLevel()

val isCharging: Boolean = Battery.isCharging()

val packageName: String = AppInfo.packageName()

val isForeground: Boolean = AppState.isAppInForeground()

💾 البيانات والتخزين والتشفير

💾 File, Storage, Time, Validation & Encryption

Kotlin

قراءة وكتابة وإضافة وحذف الملفات، مساحة التخزين والمؤقت، صيغ الوقت، التحقق من الإيميل والهاتف والروابط، وتشفير SHA-256 و Base64 عبر كلاسات File و Storage و Time و Validation و Encryption.

AppFile.writeText("demo.txt", "content")

val content: String? = AppFile.readText("demo.txt")

val freeBytes: Long = Storage.getFreeInternalStorage()

val formattedTime: String = Time.format(Time.now(), "yyyy-MM-dd HH:mm:ss")

val isValidEmail: Boolean = Validation.isValidEmail("user@example.com")

val sha256Hash: String = Encryption.sha256("password")

🔐 الأمان والبصمة واللوجر

🔐 Biometric.authenticate, Permission.isGranted, Signature & Logger

Kotlin

مصادقة البصمة الفعالة، التحقق وطلب الصلاحيات، استخراج توقيع التطبيق الرقمي SHA-1 واللوجر عبر كلاسات Biometric و Permission و Signature و Android Helper.

val canBio: Boolean = Biometric.canAuthenticate()

Biometric.authenticate(activity = fragmentActivity, title = "Biometric Auth", onSuccess = {})

val isCameraGranted: Boolean = Permission.isGranted(Manifest.permission.CAMERA)

val sha1Fingerprint: String = Signature.getAppPrimarySignatureSHA1()

Android Helper.log("Tag", "Diagnostic info")