@maximilien0405/capacitor-android-launcher 0.0.1

package/Maximilien0405CapacitorAndroidLauncher.podspec

@@ -0,0 +1,17 @@
+require 'json'
+
+package = JSON.parse(File.read(File.join(__dir__, 'package.json')))
+
+Pod::Spec.new do |s|
+  s.name = 'Maximilien0405CapacitorAndroidLauncher'
+  s.version = package['version']
+  s.summary = package['description']
+  s.license = package['license']
+  s.homepage = package['repository']['url']
+  s.author = package['author']
+  s.source = { :git => package['repository']['url'], :tag => s.version.to_s }
+  s.source_files = 'ios/Sources/**/*.{swift,h,m,c,cc,mm,cpp}'
+  s.ios.deployment_target = '14.0'
+  s.dependency 'Capacitor'
+  s.swift_version = '5.1'
+end

package/Package.swift

@@ -0,0 +1,28 @@
+// swift-tools-version: 5.9
+import PackageDescription
+
+let package = Package(
+    name: "Maximilien0405CapacitorAndroidLauncher",
+    platforms: [.iOS(.v14)],
+    products: [
+        .library(
+            name: "Maximilien0405CapacitorAndroidLauncher",
+            targets: ["AndroidLauncherPlugin"])
+    ],
+    dependencies: [
+        .package(url: "https://github.com/ionic-team/capacitor-swift-pm.git", from: "7.0.0")
+    ],
+    targets: [
+        .target(
+            name: "AndroidLauncherPlugin",
+            dependencies: [
+                .product(name: "Capacitor", package: "capacitor-swift-pm"),
+                .product(name: "Cordova", package: "capacitor-swift-pm")
+            ],
+            path: "ios/Sources/AndroidLauncherPlugin"),
+        .testTarget(
+            name: "AndroidLauncherPluginTests",
+            dependencies: ["AndroidLauncherPlugin"],
+            path: "ios/Tests/AndroidLauncherPluginTests")
+    ]
+)

package/README.md

@@ -0,0 +1,39 @@
+# @maximilien0405/capacitor-android-launcher
+
+A Capacitor plugin that lets your Android app request to become the system launcher (home screen app), remove itself as the launcher, and check if it's currently the default launcher.
+
+## Installation
+
+```bash
+npm install capacitor-android-launcher
+npx cap sync
+```
+
+And then import it like that : 
+
+```ts
+import { AndroidLauncher } from '@maximilien0405/capacitor-android-launcher';
+```
+
+## Methods
+
+``requestLauncherRole(): Promise<{ granted: boolean }>``
+Prompts the user to set your app as the default launcher.
+
+```ts
+const { granted } = await AndroidLauncher.requestLauncherRole();
+```
+<br>
+``removeLauncherRole(): Promise<void>``
+Opens system settings so the user can choose another default launcher.
+
+```ts
+await AndroidLauncher.removeLauncherRole();
+```
+<br>
+``isLauncherDefault(): Promise<{ isDefault: boolean }>``
+Checks if your app is currently the default launcher.
+
+```ts
+const { isDefault } = await AndroidLauncher.isLauncherDefault();
+```

package/android/build.gradle

@@ -0,0 +1,58 @@
+ext {
+    junitVersion = project.hasProperty('junitVersion') ? rootProject.ext.junitVersion : '4.13.2'
+    androidxAppCompatVersion = project.hasProperty('androidxAppCompatVersion') ? rootProject.ext.androidxAppCompatVersion : '1.7.0'
+    androidxJunitVersion = project.hasProperty('androidxJunitVersion') ? rootProject.ext.androidxJunitVersion : '1.2.1'
+    androidxEspressoCoreVersion = project.hasProperty('androidxEspressoCoreVersion') ? rootProject.ext.androidxEspressoCoreVersion : '3.6.1'
+}
+
+buildscript {
+    repositories {
+        google()
+        mavenCentral()
+    }
+    dependencies {
+        classpath 'com.android.tools.build:gradle:8.7.2'
+    }
+}
+
+apply plugin: 'com.android.library'
+
+android {
+    namespace "com.maximilien0405.androidlauncher"
+    compileSdk project.hasProperty('compileSdkVersion') ? rootProject.ext.compileSdkVersion : 35
+    defaultConfig {
+        minSdkVersion project.hasProperty('minSdkVersion') ? rootProject.ext.minSdkVersion : 23
+        targetSdkVersion project.hasProperty('targetSdkVersion') ? rootProject.ext.targetSdkVersion : 35
+        versionCode 1
+        versionName "1.0"
+        testInstrumentationRunner "androidx.test.runner.AndroidJUnitRunner"
+    }
+    buildTypes {
+        release {
+            minifyEnabled false
+            proguardFiles getDefaultProguardFile('proguard-android.txt'), 'proguard-rules.pro'
+        }
+    }
+    lintOptions {
+        abortOnError false
+    }
+    compileOptions {
+        sourceCompatibility JavaVersion.VERSION_21
+        targetCompatibility JavaVersion.VERSION_21
+    }
+}
+
+repositories {
+    google()
+    mavenCentral()
+}
+
+
+dependencies {
+    implementation fileTree(dir: 'libs', include: ['*.jar'])
+    implementation project(':capacitor-android')
+    implementation "androidx.appcompat:appcompat:$androidxAppCompatVersion"
+    testImplementation "junit:junit:$junitVersion"
+    androidTestImplementation "androidx.test.ext:junit:$androidxJunitVersion"
+    androidTestImplementation "androidx.test.espresso:espresso-core:$androidxEspressoCoreVersion"
+}

package/android/src/main/AndroidManifest.xml

@@ -0,0 +1,2 @@
+<manifest xmlns:android="http://schemas.android.com/apk/res/android">
+</manifest>

package/android/src/main/java/com/maximilien0405/androidlauncher/AndroidLauncher.java

@@ -0,0 +1,36 @@
+package com.maximilien0405.androidlauncher;
+
+import android.app.Activity;
+import android.content.ComponentName;
+import android.content.Context;
+import android.content.Intent;
+import android.content.pm.PackageManager;
+
+public class AndroidLauncher {
+    private final Activity activity;
+
+    public AndroidLauncher(Activity activity) {
+        this.activity = activity;
+    }
+
+    public void requestLauncherRole() {
+        Intent intent = new Intent(Intent.ACTION_MAIN);
+        intent.addCategory(Intent.CATEGORY_HOME);
+        intent.setFlags(Intent.FLAG_ACTIVITY_NEW_TASK);
+        activity.startActivity(intent);
+    }
+
+    public void removeLauncherRole() {
+        Intent intent = new Intent(Settings.ACTION_HOME_SETTINGS);
+        intent.setFlags(Intent.FLAG_ACTIVITY_NEW_TASK);
+        activity.startActivity(intent);
+    }
+
+    public boolean isLauncherApp() {
+        final Intent intent = new Intent(Intent.ACTION_MAIN);
+        intent.addCategory(Intent.CATEGORY_HOME);
+        final ResolveInfo res = activity.getPackageManager().resolveActivity(intent, PackageManager.MATCH_DEFAULT_ONLY);
+        if (res == null || res.activityInfo == null) return false;
+        return activity.getPackageName().equals(res.activityInfo.packageName);
+    }
+}

package/android/src/main/java/com/maximilien0405/androidlauncher/AndroidLauncherPlugin.java

@@ -0,0 +1,36 @@
+package com.maximilien0405.androidlauncher;
+
+import android.content.Intent;
+import com.getcapacitor.Plugin;
+import com.getcapacitor.PluginCall;
+import com.getcapacitor.annotation.CapacitorPlugin;
+
+@CapacitorPlugin(name = "AndroidLauncher")
+public class AndroidLauncherPlugin extends Plugin {
+    private AndroidLauncher implementation;
+
+    @Override
+    public void load() {
+        implementation = new AndroidLauncher(getActivity());
+    }
+
+    @com.getcapacitor.PluginMethod
+    public void requestLauncherRole(PluginCall call) {
+        implementation.requestLauncherRole();
+        call.resolve();
+    }
+
+    @com.getcapacitor.PluginMethod
+    public void removeLauncherRole(PluginCall call) {
+        implementation.removeLauncherRole();
+        call.resolve();
+    }
+
+    @com.getcapacitor.PluginMethod
+    public void isLauncherApp(PluginCall call) {
+        boolean isLauncher = implementation.isLauncherApp();
+        JSObject ret = new JSObject();
+        ret.put("isLauncher", isLauncher);
+        call.resolve(ret);
+    }
+}

package/dist/docs.json

@@ -0,0 +1,45 @@
+{
+  "api": {
+    "name": "AndroidLauncherPlugin",
+    "slug": "androidlauncherplugin",
+    "docs": "",
+    "tags": [],
+    "methods": [
+      {
+        "name": "requestLauncherRole",
+        "signature": "() => Promise<void>",
+        "parameters": [],
+        "returns": "Promise<void>",
+        "tags": [],
+        "docs": "",
+        "complexTypes": [],
+        "slug": "requestlauncherrole"
+      },
+      {
+        "name": "removeLauncherRole",
+        "signature": "() => Promise<void>",
+        "parameters": [],
+        "returns": "Promise<void>",
+        "tags": [],
+        "docs": "",
+        "complexTypes": [],
+        "slug": "removelauncherrole"
+      },
+      {
+        "name": "isLauncherApp",
+        "signature": "() => Promise<{ isLauncher: boolean; }>",
+        "parameters": [],
+        "returns": "Promise<{ isLauncher: boolean; }>",
+        "tags": [],
+        "docs": "",
+        "complexTypes": [],
+        "slug": "islauncherapp"
+      }
+    ],
+    "properties": []
+  },
+  "interfaces": [],
+  "enums": [],
+  "typeAliases": [],
+  "pluginConfigs": []
+}

package/dist/esm/definitions.d.ts

@@ -0,0 +1,7 @@
+export interface AndroidLauncherPlugin {
+    requestLauncherRole(): Promise<void>;
+    removeLauncherRole(): Promise<void>;
+    isLauncherApp(): Promise<{
+        isLauncher: boolean;
+    }>;
+}

package/dist/esm/definitions.js

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=definitions.js.map

package/dist/esm/definitions.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"definitions.js","sourceRoot":"","sources":["../../src/definitions.ts"],"names":[],"mappings":"","sourcesContent":["export interface AndroidLauncherPlugin {\n  requestLauncherRole(): Promise<void>;\n  removeLauncherRole(): Promise<void>;\n  isLauncherApp(): Promise<{ isLauncher: boolean }>;\n}"]}

package/dist/esm/index.d.ts

@@ -0,0 +1,10 @@
+export interface AndroidLauncherPlugin {
+    requestLauncherRole(): Promise<void>;
+    removeLauncherRole(): Promise<void>;
+    isLauncherApp(): Promise<{
+        isLauncher: boolean;
+    }>;
+}
+declare const AndroidLauncher: AndroidLauncherPlugin;
+export * from './definitions';
+export { AndroidLauncher };

package/dist/esm/index.js

@@ -0,0 +1,5 @@
+import { registerPlugin } from '@capacitor/core';
+const AndroidLauncher = registerPlugin('AndroidLauncher');
+export * from './definitions';
+export { AndroidLauncher };
+//# sourceMappingURL=index.js.map

package/dist/esm/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,cAAc,EAAE,MAAM,iBAAiB,CAAC;AAQjD,MAAM,eAAe,GAAG,cAAc,CAAwB,iBAAiB,CAAC,CAAC;AAEjF,cAAc,eAAe,CAAC;AAC9B,OAAO,EAAE,eAAe,EAAE,CAAC","sourcesContent":["import { registerPlugin } from '@capacitor/core';\n\nexport interface AndroidLauncherPlugin {\n  requestLauncherRole(): Promise<void>;\n  removeLauncherRole(): Promise<void>;\n  isLauncherApp(): Promise<{ isLauncher: boolean }>;\n}\n\nconst AndroidLauncher = registerPlugin<AndroidLauncherPlugin>('AndroidLauncher');\n\nexport * from './definitions';\nexport { AndroidLauncher };"]}

package/dist/plugin.cjs.js

@@ -0,0 +1,8 @@
+'use strict';
+
+var core = require('@capacitor/core');
+
+const AndroidLauncher = core.registerPlugin('AndroidLauncher');
+
+exports.AndroidLauncher = AndroidLauncher;
+//# sourceMappingURL=plugin.cjs.js.map

package/dist/plugin.cjs.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"plugin.cjs.js","sources":["esm/index.js"],"sourcesContent":["import { registerPlugin } from '@capacitor/core';\nconst AndroidLauncher = registerPlugin('AndroidLauncher');\nexport * from './definitions';\nexport { AndroidLauncher };\n//# sourceMappingURL=index.js.map"],"names":["registerPlugin"],"mappings":";;;;AACK,MAAC,eAAe,GAAGA,mBAAc,CAAC,iBAAiB;;;;"}

package/dist/plugin.js

@@ -0,0 +1,11 @@
+var capacitorAndroidLauncher = (function (exports, core) {
+	'use strict';
+
+	const AndroidLauncher = core.registerPlugin('AndroidLauncher');
+
+	exports.AndroidLauncher = AndroidLauncher;
+
+	return exports;
+
+})({}, capacitorExports);
+//# sourceMappingURL=plugin.js.map

package/dist/plugin.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"plugin.js","sources":["esm/index.js"],"sourcesContent":["import { registerPlugin } from '@capacitor/core';\nconst AndroidLauncher = registerPlugin('AndroidLauncher');\nexport * from './definitions';\nexport { AndroidLauncher };\n//# sourceMappingURL=index.js.map"],"names":["registerPlugin"],"mappings":";;;AACK,OAAC,eAAe,GAAGA,mBAAc,CAAC,iBAAiB;;;;;;;;;;"}

package/package.json

@@ -0,0 +1,77 @@
+{
+  "name": "@maximilien0405/capacitor-android-launcher",
+  "version": "0.0.1",
+  "description": "Capacitor plugin to set your android app as launcher.",
+  "main": "dist/plugin.cjs.js",
+  "module": "dist/esm/index.js",
+  "types": "dist/esm/index.d.ts",
+  "unpkg": "dist/plugin.js",
+  "files": [
+    "android/src/main/",
+    "android/build.gradle",
+    "dist/",
+    "ios/Sources",
+    "ios/Tests",
+    "Package.swift",
+    "Maximilien0405CapacitorAndroidLauncher.podspec"
+  ],
+  "author": "Maximilien Z.",
+  "license": "MIT",
+  "repository": {
+    "type": "git",
+    "url": "git+https://github.com/maximilien0405/capacitor-android-launcher.git"
+  },
+  "bugs": {
+    "url": "https://github.com/maximilien0405/capacitor-android-launcher/issues"
+  },
+  "keywords": [
+    "capacitor",
+    "plugin",
+    "native"
+  ],
+  "scripts": {
+    "verify": "npm run verify:ios && npm run verify:android && npm run verify:web",
+    "verify:ios": "xcodebuild -scheme Maximilien0405CapacitorAndroidLauncher -destination generic/platform=iOS",
+    "verify:android": "cd android && ./gradlew clean build test && cd ..",
+    "verify:web": "npm run build",
+    "lint": "npm run eslint && npm run prettier -- --check && npm run swiftlint -- lint",
+    "fmt": "npm run eslint -- --fix && npm run prettier -- --write && npm run swiftlint -- --fix --format",
+    "eslint": "eslint . --ext ts",
+    "prettier": "prettier \"**/*.{css,html,ts,js,java}\" --plugin=prettier-plugin-java",
+    "swiftlint": "node-swiftlint",
+    "docgen": "docgen --api AndroidLauncherPlugin --output-readme README.md --output-json dist/docs.json",
+    "build": "npm run clean && npm run docgen && tsc && rollup -c rollup.config.mjs",
+    "clean": "rimraf ./dist",
+    "watch": "tsc --watch",
+    "prepublishOnly": "npm run build"
+  },
+  "devDependencies": {
+    "@capacitor/android": "^7.0.0",
+    "@capacitor/core": "^7.0.0",
+    "@capacitor/docgen": "^0.3.0",
+    "@capacitor/ios": "^7.0.0",
+    "@ionic/eslint-config": "^0.4.0",
+    "@ionic/prettier-config": "^4.0.0",
+    "@ionic/swiftlint-config": "^2.0.0",
+    "eslint": "^8.57.0",
+    "prettier": "^3.4.2",
+    "prettier-plugin-java": "^2.6.6",
+    "rimraf": "^6.0.1",
+    "rollup": "^4.30.1",
+    "swiftlint": "^2.0.0",
+    "typescript": "~4.1.5"
+  },
+  "peerDependencies": {
+    "@capacitor/core": ">=7.0.0"
+  },
+  "prettier": "@ionic/prettier-config",
+  "swiftlint": "@ionic/swiftlint-config",
+  "eslintConfig": {
+    "extends": "@ionic/eslint-config/recommended"
+  },
+  "capacitor": {
+    "android": {
+      "src": "android"
+    }
+  }
+}