Android Helper Documentation
Android 17 (API 37) Ready
Kotlin Coroutines & DataStore
Flutter MethodChannel Bridge تحميل كوتلن Demo APK اسأل الذكاء الاصطناعي عن المكتبة:
📦 التثبيت والإعداد (Installation)
1️⃣ الخطوة الأولى: إضافة التبعية لملف البناء (Gradle / Version Catalog)
اختر طريقتك المفضلة لبناء المشروع لإدراج مستودع JitPack وتبعية المكتبة.
// 1. Add version & library in gradle/libs.versions.toml
[versions]
androidhelper = "1.0.0-beta01"
[libraries]
androidhelper = { group = "com.github.zaitxcode", name = "androidhelper", version.ref = "androidhelper" }
// 2. Add JitPack repository in settings.gradle.kts
repositories { google(); mavenCentral(); maven { url = uri("https://jitpack.io") } }
// 3. Add dependency in app/build.gradle.kts
dependencies { implementation(libs.androidhelper) }
2️⃣ الخطوة الثانية: تهيئة المكتبة بداخل كلاس Application أو Activity
Kotlinاستدعِ AppHelper.initialize(context) بداخل دالة Application.onCreate() أو Activity.onCreate().
import android.app.Application
import com.zaitxcode.android.core.AppHelper
class ExampleApplication : Application() {
override fun onCreate() {
super.onCreate()
AppHelper.initialize(this)
}
}
🌐 الشبكة والاتصال (Network)
🌐 Network.isConnected, activeTransport, isWifiConnected & getIpAddress
التحقق من حالة الاتصال بالإنترنت والاتصال المزدوج والإنترنت المؤكد وعنوان الـ 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 ip: String? = Network.getIpAddress()
🔗 المقاصد والأفعال الخارجية (Intents)
🔗 Intent.openWhatsApp, dial, sendSms, sendEmail, openAppSettings
فتح الروابط، محادثات الواتساب، الاتصال المباشر، إرسال البريد الإلكتروني، الخرائط، إعدادات التطبيق ومتجر بلاي فورياً عبر كلاسات Intent و Browser.
import com.zaitxcode.android.content.Intent
import com.zaitxcode.android.browser.Browser
Browser.openUrl("https://docs.zaitxcode.com/androidhelper")
Intent.openWhatsApp("+201000000000", "Hello from Android Helper")
Intent.dial("+201000000000")
Intent.sendSms("+201000000000", "SMS message text")
Intent.sendEmail("support@example.com", "App Support", "Message body")
Intent.shareText("Text to share")
Intent.openMap(30.0444, 31.2357, "Cairo, Egypt")
Intent.openAppSettings()
📋 الحافظة والاهتزاز وحظر الشاشة
📋 Clipboard.copyText, Vibration.vibrate & Screen.blockCapture
تشغيل الاهتزاز الفعلي، النسخ وقراءة مسح الحافظة، وحظر التقاط الشاشة عبر كلاسات Clipboard و Vibration و Screen.
import com.zaitxcode.android.content.Clipboard
import com.zaitxcode.android.hardware.Vibration
import com.zaitxcode.android.view.Screen
Clipboard.copyText("Hello Android Helper")
val text: String? = Clipboard.getText()
Vibration.vibrate(200)
Screen.blockCapture()
🔐 الأمان والبصمة واللوجر
🔐 Biometric.canAuthenticate, Permission.isGranted & AppHelper.log
مصادقة البصمة الفعالة، التحقق وطلب الصلاحيات، استخراج توقيع التطبيق الرقمي SHA-1 واللوجر عبر كلاسات Biometric و Permission و Signature و AppHelper.
import com.zaitxcode.android.hardware.Biometric
val canBio: Boolean = Biometric.canAuthenticate()
AppHelper.log("AppTag", "Log diagnostic message")