My personal Flutter plugin with support for both Android and Linux platforms #

ThanPkg V4.5.1 #

Added #

ThanPkg.android.app.setWallpaper(path: [image fullpath])

AndroidSettings #

• AndroidSettings.*

await ThanPkg.android.intent.callSettingIntent(
  actionType: AndroidSettings.ACTION_VPN_SETTINGS);

AndroidIntents #

• AndroidIntents.*

await ThanPkg.android.intent.callIntent(
  intentType: AndroidIntents.ACTION_DIAL,
  uri: Uri.parse('tel:09788269103'),
);

await ThanPkg.android.intent.callIntent(
  intentType: AndroidIntents.ACTION_VIEW,
  uri: Uri.parse('https://github.com/'),
);

//call intent `open share dialog`
await ThanPkg.android.intent.callIntent(
  intentType: AndroidIntentData.ACTION_SEND,
  extras: {
    AndroidIntentData.EXTRA_TEXT: "Hello World",
    AndroidIntentData.EXTRA_SUBJECT: "Subject Example",
  },
  mimeType: "text/plain", // important
);

RecentDB #

//main
TRecentDB.init(rootPath: 'test.json');

//usage
await TRecentDB.getInstance.putString('name', 'i am db name');
await TRecentDB.getInstance.putBool('isDark', true);
await TRecentDB.getInstance.putInt('age', 27);
await TRecentDB.getInstance.putDouble('height', 2.5);V

//get
print(TRecentDB.getInstance.getString('name', def: 'def'));

Android Webview #

TWebview(url: 'http//'),
//fetch html
final html = ThanPkg.android.webview.onPageFinished();
ThanPkg.android.webview.evaluateJavascript(script: 'js', isEscapeForJsonJs: true)
ThanPkg.android.webview.goBack()
ThanPkg.android.webview.goForward()
ThanPkg.android.webview.clearCache(includeDiskFiles: false)
ThanPkg.android.webview.clearHistory()
ThanPkg.android.webview.getHtml()
ThanPkg.android.webview.zoomIn()
ThanPkg.android.webview.zoomOut()
ThanPkg.android.webview.reload()

Android Media #

ThanPkg.android.media.createTexture()
ThanPkg.android.media.play(path: 'path', isVideo: bool)
ThanPkg.android.media.currentPosition()
ThanPkg.android.media.duration()
ThanPkg.android.media.trackInfo()
//just working!...Don't use;
TVideoView(path: path, controller: controller)

Android Notification #

ThanPkg.platform.showNotification(title: 'i am title');
ThanPkg.android.notiUtil.showNotification(title: 'i am title');
ThanPkg.linux.notiUtil.showNotification(title: 'i am title');

final isPermissionGranted = await ThanPkg.android.notiUtil.checkAndRequestNotificationPermission();

await ThanPkg.android.notiUtil.showNotification(
  notificationId: 2,
  channelId: 'message',
  title: 'ငါက noti',
  content: 'နေကောင်းလားဟေ့');

for (int i = 1; i <= 100; i++) {
  await ThanPkg.android.notiUtil.showProgressNotification(
  progress: i,
  title: 'Progress',
  content: 'Progress $i%',
  );
  await Future.delayed(Duration(milliseconds: 100));
}
await Future.delayed(Duration(milliseconds: 500));
await ThanPkg.android.notiUtil.showCompleteNotification(
  title: 'Progress',
  content: 'Progress Done');

Android Permission #

await ThanPkg.android.permission.*

//<uses-permission android:name="android.permission.POST_NOTIFICATIONS" />
checkAndRequestNotificationPermission()
//<uses-permission android:name="android.permission.REQUEST_IGNORE_BATTERY_OPTIMIZATIONS" />
requestBatteryOptimizationPermission()
//<uses-permission android:name="android.permission.CAMERA" />
requestCameraPermission()
//<uses-permission android:name="android.permission.REQUEST_INSTALL_PACKAGES"/>
checkCanRequestPackageInstallsPermission()
//<uses-permission android:name="android.permission.QUERY_ALL_PACKAGES" tools:ignore="QueryAllPackagesPermission" />
requestPackageInstallPermission()
//<!-- Location permissions -->
//<uses-permission android:name="android.permission.ACCESS_FINE_LOCATION" />
//<uses-permission android:name="android.permission.ACCESS_COARSE_LOCATION" />
//<!-- Android 10+ background location access (optional) -->
//<uses-permission android:name="android.permission.ACCESS_BACKGROUND_LOCATION" />
requestLocationPermission()

Android App List #

final appList = await ThanPkg.android.app.getInstalledAppsList();

final app = appList.first;
Text('appName: ${app.appName}'),
Text('packageName: ${app.packageName}'),
Text('versionName: ${app.versionName}'),
Text('versionCode: ${app.versionCode}'),
Text('Size: ${app.size!.getSizeLabel()}'),
IconButton(
    onPressed: () async {
      final outfile =
          await ThanPkg.platform.getAppExternalPath();
      await app.export('$outfile/${app.appName}.apk');
      debugPrint('saved');
    },
    icon: Icon(Icons.save))
SizedBox(
width: 50,
height: 50,
child: Image.memory(app.coverData!)),

Needed lib for linux #

sudo apt install net-tools  // wifi
sudo apt install poppler-utils //pdf thumbnail
sudo apt install ffmpeg //video thumbnail

//screenshoot
sudo apt install scrot   # Ubuntu/Debian
sudo dnf install scrot   # Fedora
sudo pacman -S scrot     # Arch

Platforms Methods #

• ThanPkg.platform.*
• ThanPkg.platform.checkScreenOrientation
• ThanPkg.platform.genPdfThumbnail
• ThanPkg.platform.genVideoThumbnail
• ThanPkg.platform.getAppBatteryLevel
• ThanPkg.platform.getDeviceId

Linux #

• ThanPkg.linux.*

Android #

• ThanPkg.android.*

TMap #

//class
TMap
// extension
final map = {'name': 'than', 'age': 29};
map.getString(['name-'], def: 'i def');
map.getBool(['isTrue']);
map.getDouble(['level']);
map.getInt(['age']);

TJsonDatabase #

class Person {}

class PerDB extends TJsonDatabase<Person> {
  PerDB({required super.path});

  @override
  Person fromMap(Map<String, dynamic> map) {
    // TODO: implement fromMap
    throw UnimplementedError();
  }

  @override
  Map<String, dynamic> toMap(Person value) {
    // TODO: implement toMap
    throw UnimplementedError();
  }
}
final db = PerDB(path: 'path');

TDatabase #

class Person {}

class PerIO extends DataIO {
  @override
  Future<String> read(String source) {
    // TODO: implement read
    throw UnimplementedError();
  }

  @override
  Future<void> write(String source, String data) {
    // TODO: implement write
    throw UnimplementedError();
  }
}
// or you can use TJsonConverter
class PerConverter2 extends JsonConverter<Person>{
  @override
  Person from(Map<String, dynamic> value) {
    // TODO: implement from
    throw UnimplementedError();
  }

  @override
  Map<String, dynamic> to(Person value) {
    // TODO: implement to
    throw UnimplementedError();
  }
}

class PerConverter extends TConverter<Person, Map<String, dynamic>> {
  @override
  Person from(Map<String, dynamic> value) {
    // TODO: implement from
    throw UnimplementedError();
  }

  @override
  Map<String, dynamic> to(Person value) {
    // TODO: implement to
    throw UnimplementedError();
  }
}

class PerDB extends TDatabase<Person> {
  PerDB({
    required super.io,
    required super.converter,
    required super.databasePath,
  });

  @override
  Future<void> add(Person value) {
    // TODO: implement add
    throw UnimplementedError();
  }

  @override
  Future<void> delete(Person value) {
    // TODO: implement delete
    throw UnimplementedError();
  }

  @override
  Future<List<Person>> getAll() {
    // TODO: implement getAll
    throw UnimplementedError();
  }

  @override
  Future<void> update(Person value) {
    // TODO: implement update
    throw UnimplementedError();
  }
}

final db = PerDB(io: PerIO(), converter: PerConverter(), databasePath: '');

TDatabase Listener #

class _MyAppState extends State<MyApp> with TDatabaseListener {
  @override
  void initState() {
    db.addListener(this);
    super.initState();
    init();
  }

  @override
  void dispose() {
    db.removeListener(this);
    super.dispose();
  }

  @override
  void onDatabaseChanged() {
    // TODO: implement onDatabaseChanged
  }
}

Map Services #

//new
MapServices.getBool({}, ['name'])
MapServices.getInt({}, ['name'])
MapServices.getString({}, ['name'])
MapServices.getDouble({}, ['name'])
//old
MapServices.get<String>({}, ['name'], defaultValue: '');
MapServices.get<int>({}, ['num'], defaultValue: 1);
MapServices.get<double>({}, ['height'], defaultValue: 0.0);

Methods #

ThanPkg.appUtil.getParseMinutes(minutes);
ThanPkg.appUtil.copyText(text);
ThanPkg.appUtil.pasteText();
await ThanPkg.appUtil.clearImageCache();

Extensions #

// extension
DateTime.now().toParseTime();
DateTime.now().toTimeAgo();
//double
0.0.toFileSizeLabel();
//FileSystemEntityExtension
FileSystemEntityExtension.getName(withExt: false)

//PlatformExtension
PlatformExtension.isDesktop();
PlatformExtension.isMobile();

//StringExtension
"".toCaptalize();
"".getName();
"".getExt();
//TextEditingControllerExtension
TextEditingController().selectAll();

Thumbnail for linux,android #

await ThanPkg.platform.genPdfThumbnail(pathList: [
SrcDestType(src: '$path/Download/1-50.pdf', dist: '$path/test.png'),
]);

await ThanPkg.platform.genVideoThumbnail(pathList: [
SrcDestType(
    src: '$path/Download/catch.mp4', dist: '$path/catch-video.png'),
]);

Launch #

• ThanPkg.android.app.launch

• ThanPkg.linux.app.launch

• ThanPkg.platform.launch

• Ubuntu/Debian

sudo apt install xdg-utils

• Arch

sudo pacman -S xdg-utils

• Fedora

sudo dnf install xdg-utils

Android ScreenOrientation #

final type = await ThanPkg.android.app.getOrientation();
if (type == null) return;
if (type == ScreenOrientationTypes.Portrait) {
await ThanPkg.android.app
    .requestOrientation(type: ScreenOrientationTypes.Landscape);
await ThanPkg.android.app.showFullScreen();
} else {
ThanPkg.android.app
    .requestOrientation(type: ScreenOrientationTypes.Portrait);
await ThanPkg.android.app.hideFullScreen();
}

Android Manifest #

<application>
<provider
    android:name="than.plugin.than_pkg.TContentProvider"
    android:authorities="${applicationId}.provider"
    android:exported="false"
    android:grantUriPermissions="true" />

</application>

• for above android xml code

Future<void> openPdfWithIntent({required String path})
Future<void> openVideoWithIntent({required String path})
Future<void> installApk({required String path})

Android Thumbnail #

• ThanPkg.android.thumbnail

Future<void> genVideoThumbnailList
Future<String?> genVideoThumbnail
Future<void> genPdfCoverList
Future<String> genPdfImage
Future<int> getPdfPageCount

Android Camera #

final filePath = await ThanPkg.android.camera.openCamera();

Android Storage Permission (All Version) #

if (!await ThanPkg.android.permission.isStoragePermissionGranted()) {
    await ThanPkg.android.permission.requestStoragePermission();
    return;
}
if (!await ThanPkg.android.permission.isCameraPermission()) {
    await ThanPkg.android.permission.requestCameraPermission();
    return;
}

• ThanPkg.android.permission

Future<void> checkCanRequestPackageInstallsPermission
Future<bool> isPackageInstallPermission()
Future<bool> isStoragePermissionGranted()
Future<bool> isCameraPermission()
Future<bool> isLocationPermission()
Future<void> requestStoragePermission()
Future<void> requestPackageInstallPermission()
Future<void> requestCameraPermission()
Future<void> requestLocationPermission()

Android && linux #

//old method
await ThanPkg.windowManagerensureInitialized();
await ThanPkg.platform.toggleFullScreen(isFullScreen: true);
await ThanPkg.platform.getAppRootPath();
await ThanPkg.platform.getAppExternalPath();
await ThanPkg.platform.getWifiAddressList();
await ThanPkg.platform.genPdfCover(outDirPath: '', pdfPathList: []);
await ThanPkg.platform.genVideoCover(outDirPath: '', videoPathList: []);

Android only #

//old method
await ThanPkg.platform.getAppFilePath();
await ThanPkg.platform.isAppSystemThemeDarkMode();
await ThanPkg.platform.isAppInternetConnected();
await ThanPkg.platform.getAppBatteryLevel();
await ThanPkg.platform.getLastKnownLocation();
await ThanPkg.platform.getInstalledApps();
await ThanPkg.platform.checkScreenOrientation();
await ThanPkg.platform.requestScreenOrientation(type: ScreenOrientationTypes.Portrait);
//android device info <Map> type
await ThanPkg.platform.getAndroidDeviceInfo()
await ThanPkg.platform.openUrl(url: '');
await ThanPkg.platform.getPlatformVersion();
await ThanPkg.platform.getDeviceId();
await ThanPkg.platform.toggleKeepScreen(isKeep: false);
await ThanPkg.platform.toggleFullScreen(isFullScreen: !isFullScreen);
await ThanPkg.platform.getLocalIpAddress();
await ThanPkg.platform.getWifiAddress();

Android AndroidManifest Permission #

<uses-permission android:name="android.permission.INTERNET"/>
<uses-permission android:name="android.permission.MANAGE_EXTERNAL_STORAGE"
    tools:ignore="ScopedStorage" />
<uses-permission android:name="android.permission.WRITE_EXTERNAL_STORAGE" />
<uses-permission android:name="android.permission.READ_EXTERNAL_STORAGE" />

<uses-permission android:name="android.permission.ACCESS_WIFI_STATE" />
<uses-permission android:name="android.permission.ACCESS_NETWORK_STATE"/>

<uses-permission android:name="android.permission.POST_NOTIFICATIONS" />

<uses-permission android:name="android.permission.REQUEST_INSTALL_PACKAGES"/>
<uses-permission android:name="android.permission.QUERY_ALL_PACKAGES"
    tools:ignore="QueryAllPackagesPermission" />

<uses-permission android:name="android.permission.REQUEST_IGNORE_BATTERY_OPTIMIZATIONS" />

<uses-permission android:name="android.permission.CAMERA" />
<!-- Location permissions -->
<uses-permission android:name="android.permission.ACCESS_FINE_LOCATION" />
<uses-permission android:name="android.permission.ACCESS_COARSE_LOCATION" />

<!-- Android 10+ background location access (optional) -->
<uses-permission android:name="android.permission.ACCESS_BACKGROUND_LOCATION" />