@capawesome/capacitor-app-launcher 0.0.1

package/CapawesomeCapacitorAppLauncher.podspec

@@ -0,0 +1,17 @@
+require 'json'
+
+package = JSON.parse(File.read(File.join(__dir__, 'package.json')))
+
+Pod::Spec.new do |s|
+  s.name = 'CapawesomeCapacitorAppLauncher'
+  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/Plugin/**/*.{swift,h,m,c,cc,mm,cpp}'
+  s.ios.deployment_target = '15.0'
+  s.dependency 'Capacitor'
+  s.swift_version = '5.1'
+end

package/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2026 Robin Genz
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.

package/Package.swift

@@ -0,0 +1,28 @@
+// swift-tools-version: 5.9
+import PackageDescription
+
+let package = Package(
+    name: "CapawesomeCapacitorAppLauncher",
+    platforms: [.iOS(.v15)],
+    products: [
+        .library(
+            name: "CapawesomeCapacitorAppLauncher",
+            targets: ["AppLauncherPlugin"])
+    ],
+    dependencies: [
+        .package(url: "https://github.com/ionic-team/capacitor-swift-pm.git", from: "8.0.0")
+    ],
+    targets: [
+        .target(
+            name: "AppLauncherPlugin",
+            dependencies: [
+                .product(name: "Capacitor", package: "capacitor-swift-pm"),
+                .product(name: "Cordova", package: "capacitor-swift-pm")
+            ],
+            path: "ios/Plugin"),
+        .testTarget(
+            name: "AppLauncherPluginTests",
+            dependencies: ["AppLauncherPlugin"],
+            path: "ios/PluginTests")
+    ]
+)

package/README.md

@@ -0,0 +1,218 @@
+# Capacitor App Launcher Plugin
+
+Capacitor plugin to check if an app can be opened and to open it.
+
+<div class="capawesome-z29o10a">
+  <a href="https://cloud.capawesome.io/" target="_blank">
+    <img alt="Deliver Live Updates to your Capacitor app with Capawesome Cloud" src="https://cloud.capawesome.io/assets/banners/cloud-build-and-deploy-capacitor-apps.png?t=1" />
+  </a>
+</div>
+
+## Features
+
+- 🔗 **Open apps**: Open another app by its URL scheme or package name.
+- ✅ **Availability**: Check whether an app can be opened before trying to open it.
+- 🤖 **Package names**: Check and open apps by their package name on Android.
+- 🔒 **App Store safe**: Uses only official platform APIs.
+- 📦 **CocoaPods & SPM**: Supports CocoaPods and Swift Package Manager for iOS.
+- 🔁 **Up-to-date**: Always supports the latest Capacitor version.
+- 🤝 **Compatibility**: Works alongside the [Maps Launcher](https://capawesome.io/docs/sdks/capacitor/maps-launcher/) and [Settings Launcher](https://capawesome.io/docs/sdks/capacitor/settings-launcher/) plugins.
+
+Missing a feature? Just [open an issue](https://github.com/capawesome-team/capacitor-plugins/issues) and we'll take a look!
+
+## Newsletter
+
+Stay up to date with the latest news and updates about the Capawesome, Capacitor, and Ionic ecosystem by subscribing to our [Capawesome Newsletter](https://cloud.capawesome.io/newsletter/).
+
+## Compatibility
+
+| Plugin Version | Capacitor Version | Status         |
+| -------------- | ----------------- | -------------- |
+| 0.x.x          | >=8.x.x           | Active support |
+
+## Installation
+
+You can use our **AI-Assisted Setup** to install the plugin.
+Add the [Capawesome Skills](https://github.com/capawesome-team/skills) to your AI tool using the following command:
+
+```bash
+npx skills add capawesome-team/skills --skill capacitor-plugins
+```
+
+Then use the following prompt:
+
+```
+ Use the `capacitor-plugins` skill from `capawesome-team/skills` to install the `@capawesome/capacitor-app-launcher` plugin in my project.
+```
+
+If you prefer **Manual Setup**, install the plugin by running the following commands and follow the platform-specific instructions below:
+
+```bash
+npm install @capawesome/capacitor-app-launcher
+npx cap sync
+```
+
+### Android
+
+Starting with Android 11 (API level 30), apps must declare the packages and URL schemes they want to check or open in the [`<queries>`](https://developer.android.com/training/package-visibility) element of their `AndroidManifest.xml`.
+
+**If you do not add the corresponding `<queries>` entries, `canOpenUrl(...)` always resolves with `value: false` and `openUrl(...)` may resolve with `completed: false`.**
+
+Add an entry for **every** package name and URL scheme you pass to the plugin. For example, to check and open the Gmail app (package name `com.google.android.gm`) and any `mailto:` URL, add the following to your `android/app/src/main/AndroidManifest.xml` before or after the `application` tag:
+
+```xml
+<queries>
+    <!-- Required to check and open a specific package name. -->
+    <package android:name="com.google.android.gm" />
+    <!-- Required to check and open a specific URL scheme. -->
+    <intent>
+        <action android:name="android.intent.action.VIEW" />
+        <data android:scheme="mailto" />
+    </intent>
+</queries>
+```
+
+### iOS
+
+On iOS, every URL scheme you want to check with `canOpenUrl(...)` must be declared in the [`LSApplicationQueriesSchemes`](https://developer.apple.com/documentation/bundleresources/information_property_list/lsapplicationqueriesschemes) key of your app's `Info.plist`.
+
+**If you do not add the corresponding entries, `canOpenUrl(...)` always resolves with `value: false`.**
+
+Add an entry for **every** URL scheme you pass to the plugin. For example, to check any `mailto:` URL, add the following to your `ios/App/App/Info.plist`:
+
+```xml
+<key>LSApplicationQueriesSchemes</key>
+<array>
+    <string>mailto</string>
+</array>
+```
+
+## Configuration
+
+No configuration required for this plugin.
+
+## Usage
+
+```typescript
+import { AppLauncher } from '@capawesome/capacitor-app-launcher';
+
+const canOpenUrl = async () => {
+  const { value } = await AppLauncher.canOpenUrl({ url: 'mailto:' });
+  return value;
+};
+
+const openUrl = async () => {
+  const { completed } = await AppLauncher.openUrl({ url: 'mailto:' });
+  return completed;
+};
+```
+
+## API
+
+<docgen-index>
+
+* [`canOpenUrl(...)`](#canopenurl)
+* [`openUrl(...)`](#openurl)
+* [Interfaces](#interfaces)
+
+</docgen-index>
+
+<docgen-api>
+<!--Update the source file JSDoc comments and rerun docgen to update the docs below-->
+
+### canOpenUrl(...)
+
+```typescript
+canOpenUrl(options: CanOpenUrlOptions) => Promise<CanOpenUrlResult>
+```
+
+Check if an app can be opened with the given URL.
+
+On **iOS**, every URL scheme you want to check must be declared in the
+`LSApplicationQueriesSchemes` key of your app's `Info.plist`. Otherwise
+this method always resolves with `value: false`.
+
+On **Android**, every package name or URL scheme you want to check must be
+declared in the `&lt;queries&gt;` element of your app's `AndroidManifest.xml`.
+Otherwise this method always resolves with `value: false`.
+
+| Param         | Type                                                            |
+| ------------- | --------------------------------------------------------------- |
+| **`options`** | <code><a href="#canopenurloptions">CanOpenUrlOptions</a></code> |
+
+**Returns:** <code>Promise&lt;<a href="#canopenurlresult">CanOpenUrlResult</a>&gt;</code>
+
+**Since:** 0.1.0
+
+--------------------
+
+
+### openUrl(...)
+
+```typescript
+openUrl(options: OpenUrlOptions) => Promise<OpenUrlResult>
+```
+
+Open an app with the given URL.
+
+| Param         | Type                                                      |
+| ------------- | --------------------------------------------------------- |
+| **`options`** | <code><a href="#openurloptions">OpenUrlOptions</a></code> |
+
+**Returns:** <code>Promise&lt;<a href="#openurlresult">OpenUrlResult</a>&gt;</code>
+
+**Since:** 0.1.0
+
+--------------------
+
+
+### Interfaces
+
+
+#### CanOpenUrlResult
+
+| Prop        | Type                 | Description                                                                                                                                                  | Since |
+| ----------- | -------------------- | ------------------------------------------------------------------------------------------------------------------------------------------------------------ | ----- |
+| **`value`** | <code>boolean</code> | Whether or not the app can be opened with the given URL. On the web, this is always `true` because the browser cannot determine whether a URL can be opened. | 0.1.0 |
+
+
+#### CanOpenUrlOptions
+
+| Prop      | Type                | Description                                                                                                                                                                           | Since |
+| --------- | ------------------- | ------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | ----- |
+| **`url`** | <code>string</code> | The URL to check. On **iOS**, this must be a URL scheme (e.g. `mailto:`). On **Android**, this can be a URL scheme (e.g. `mailto:`) or a package name (e.g. `com.google.android.gm`). | 0.1.0 |
+
+
+#### OpenUrlResult
+
+| Prop            | Type                 | Description                                     | Since |
+| --------------- | -------------------- | ----------------------------------------------- | ----- |
+| **`completed`** | <code>boolean</code> | Whether or not the app was opened successfully. | 0.1.0 |
+
+
+#### OpenUrlOptions
+
+| Prop      | Type                | Description                                                                                                                                                                          | Since |
+| --------- | ------------------- | ------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------ | ----- |
+| **`url`** | <code>string</code> | The URL to open. On **iOS**, this must be a URL scheme (e.g. `mailto:`). On **Android**, this can be a URL scheme (e.g. `mailto:`) or a package name (e.g. `com.google.android.gm`). | 0.1.0 |
+
+</docgen-api>
+
+## Migrating from `@capacitor/app-launcher`
+
+This plugin is a drop-in replacement for the official `@capacitor/app-launcher` plugin. The API is identical, so you only need to change the import and installation.
+
+| `@capacitor/app-launcher`                    | App Launcher                                 |
+| -------------------------------------------- | -------------------------------------------- |
+| `AppLauncher.canOpenUrl({ url })`            | `AppLauncher.canOpenUrl({ url })`            |
+| `AppLauncher.openUrl({ url })`               | `AppLauncher.openUrl({ url })`               |
+
+On Android, the `url` may be a URL scheme or a package name for both `canOpenUrl(...)` and `openUrl(...)`.
+
+## Changelog
+
+See [CHANGELOG.md](https://github.com/capawesome-team/capacitor-plugins/blob/main/packages/app-launcher/CHANGELOG.md).
+
+## License
+
+See [LICENSE](https://github.com/capawesome-team/capacitor-plugins/blob/main/packages/app-launcher/LICENSE).

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.1'
+    androidxJunitVersion = project.hasProperty('androidxJunitVersion') ? rootProject.ext.androidxJunitVersion : '1.3.0'
+    androidxEspressoCoreVersion = project.hasProperty('androidxEspressoCoreVersion') ? rootProject.ext.androidxEspressoCoreVersion : '3.7.0'
+}
+
+buildscript {
+    repositories {
+        google()
+        mavenCentral()
+    }
+    dependencies {
+        classpath 'com.android.tools.build:gradle:8.13.0'
+    }
+}
+
+apply plugin: 'com.android.library'
+
+android {
+    namespace = "io.capawesome.capacitorjs.plugins.applauncher"
+    compileSdk = project.hasProperty('compileSdkVersion') ? rootProject.ext.compileSdkVersion : 36
+    defaultConfig {
+        minSdkVersion project.hasProperty('minSdkVersion') ? rootProject.ext.minSdkVersion : 24
+        targetSdkVersion project.hasProperty('targetSdkVersion') ? rootProject.ext.targetSdkVersion : 36
+        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/io/capawesome/capacitorjs/plugins/applauncher/AppLauncher.java

@@ -0,0 +1,79 @@
+package io.capawesome.capacitorjs.plugins.applauncher;
+
+import android.content.ActivityNotFoundException;
+import android.content.Context;
+import android.content.Intent;
+import android.content.pm.PackageManager;
+import android.content.pm.ResolveInfo;
+import android.net.Uri;
+import androidx.annotation.NonNull;
+import io.capawesome.capacitorjs.plugins.applauncher.classes.options.CanOpenUrlOptions;
+import io.capawesome.capacitorjs.plugins.applauncher.classes.options.OpenUrlOptions;
+import io.capawesome.capacitorjs.plugins.applauncher.classes.results.CanOpenUrlResult;
+import io.capawesome.capacitorjs.plugins.applauncher.classes.results.OpenUrlResult;
+import io.capawesome.capacitorjs.plugins.applauncher.interfaces.NonEmptyResultCallback;
+
+public class AppLauncher {
+
+    @NonNull
+    private final AppLauncherPlugin plugin;
+
+    public AppLauncher(@NonNull AppLauncherPlugin plugin) {
+        this.plugin = plugin;
+    }
+
+    public void canOpenUrl(@NonNull CanOpenUrlOptions options, @NonNull NonEmptyResultCallback<CanOpenUrlResult> callback) {
+        boolean value = canOpenUrl(options.getUrl());
+        callback.success(new CanOpenUrlResult(value));
+    }
+
+    public void openUrl(@NonNull OpenUrlOptions options, @NonNull NonEmptyResultCallback<OpenUrlResult> callback) {
+        boolean completed = openUrl(options.getUrl());
+        callback.success(new OpenUrlResult(completed));
+    }
+
+    private boolean canOpenUrl(@NonNull String url) {
+        if (isPackageInstalled(url)) {
+            return true;
+        }
+        Intent intent = new Intent(Intent.ACTION_VIEW, Uri.parse(url));
+        ResolveInfo resolveInfo = getContext().getPackageManager().resolveActivity(intent, 0);
+        return resolveInfo != null;
+    }
+
+    @NonNull
+    private Context getContext() {
+        return plugin.getContext();
+    }
+
+    private boolean isPackageInstalled(@NonNull String packageName) {
+        try {
+            getContext().getPackageManager().getPackageInfo(packageName, 0);
+            return true;
+        } catch (PackageManager.NameNotFoundException exception) {
+            return false;
+        }
+    }
+
+    private boolean openUrl(@NonNull String url) {
+        Intent viewIntent = new Intent(Intent.ACTION_VIEW, Uri.parse(url));
+        viewIntent.addFlags(Intent.FLAG_ACTIVITY_NEW_TASK);
+        try {
+            getContext().startActivity(viewIntent);
+            return true;
+        } catch (ActivityNotFoundException exception) {
+            // Fall back to launching the app by its package name.
+        }
+        Intent launchIntent = getContext().getPackageManager().getLaunchIntentForPackage(url);
+        if (launchIntent == null) {
+            return false;
+        }
+        launchIntent.addFlags(Intent.FLAG_ACTIVITY_NEW_TASK);
+        try {
+            getContext().startActivity(launchIntent);
+            return true;
+        } catch (ActivityNotFoundException exception) {
+            return false;
+        }
+    }
+}

package/android/src/main/java/io/capawesome/capacitorjs/plugins/applauncher/AppLauncherPlugin.java

@@ -0,0 +1,98 @@
+package io.capawesome.capacitorjs.plugins.applauncher;
+
+import androidx.annotation.NonNull;
+import androidx.annotation.Nullable;
+import com.getcapacitor.Logger;
+import com.getcapacitor.Plugin;
+import com.getcapacitor.PluginCall;
+import com.getcapacitor.PluginMethod;
+import com.getcapacitor.annotation.CapacitorPlugin;
+import io.capawesome.capacitorjs.plugins.applauncher.classes.CustomException;
+import io.capawesome.capacitorjs.plugins.applauncher.classes.options.CanOpenUrlOptions;
+import io.capawesome.capacitorjs.plugins.applauncher.classes.options.OpenUrlOptions;
+import io.capawesome.capacitorjs.plugins.applauncher.classes.results.CanOpenUrlResult;
+import io.capawesome.capacitorjs.plugins.applauncher.classes.results.OpenUrlResult;
+import io.capawesome.capacitorjs.plugins.applauncher.interfaces.NonEmptyResultCallback;
+import io.capawesome.capacitorjs.plugins.applauncher.interfaces.Result;
+
+@CapacitorPlugin(name = "AppLauncher")
+public class AppLauncherPlugin extends Plugin {
+
+    public static final String ERROR_UNKNOWN_ERROR = "An unknown error has occurred.";
+    public static final String TAG = "AppLauncherPlugin";
+
+    private AppLauncher implementation;
+
+    @Override
+    public void load() {
+        super.load();
+        this.implementation = new AppLauncher(this);
+    }
+
+    @PluginMethod
+    public void canOpenUrl(PluginCall call) {
+        try {
+            CanOpenUrlOptions options = new CanOpenUrlOptions(call);
+            NonEmptyResultCallback<CanOpenUrlResult> callback = new NonEmptyResultCallback<>() {
+                @Override
+                public void success(@NonNull CanOpenUrlResult result) {
+                    resolveCall(call, result);
+                }
+
+                @Override
+                public void error(Exception exception) {
+                    rejectCall(call, exception);
+                }
+            };
+            implementation.canOpenUrl(options, callback);
+        } catch (Exception exception) {
+            rejectCall(call, exception);
+        }
+    }
+
+    @PluginMethod
+    public void openUrl(PluginCall call) {
+        try {
+            OpenUrlOptions options = new OpenUrlOptions(call);
+            NonEmptyResultCallback<OpenUrlResult> callback = new NonEmptyResultCallback<>() {
+                @Override
+                public void success(@NonNull OpenUrlResult result) {
+                    resolveCall(call, result);
+                }
+
+                @Override
+                public void error(Exception exception) {
+                    rejectCall(call, exception);
+                }
+            };
+            implementation.openUrl(options, callback);
+        } catch (Exception exception) {
+            rejectCall(call, exception);
+        }
+    }
+
+    private void rejectCall(@NonNull PluginCall call, @NonNull Exception exception) {
+        String message = exception.getMessage();
+        if (message == null) {
+            message = ERROR_UNKNOWN_ERROR;
+        }
+        String code = null;
+        if (exception instanceof CustomException) {
+            code = ((CustomException) exception).getCode();
+        }
+        Logger.error(TAG, message, exception);
+        call.reject(message, code);
+    }
+
+    private void resolveCall(@NonNull PluginCall call) {
+        call.resolve();
+    }
+
+    private void resolveCall(@NonNull PluginCall call, @Nullable Result result) {
+        if (result == null) {
+            call.resolve();
+        } else {
+            call.resolve(result.toJSObject());
+        }
+    }
+}

package/android/src/main/java/io/capawesome/capacitorjs/plugins/applauncher/classes/CustomException.java

@@ -0,0 +1,20 @@
+package io.capawesome.capacitorjs.plugins.applauncher.classes;
+
+import androidx.annotation.NonNull;
+import androidx.annotation.Nullable;
+
+public class CustomException extends Exception {
+
+    @Nullable
+    private final String code;
+
+    public CustomException(@Nullable String code, @NonNull String message) {
+        super(message);
+        this.code = code;
+    }
+
+    @Nullable
+    public String getCode() {
+        return code;
+    }
+}

package/android/src/main/java/io/capawesome/capacitorjs/plugins/applauncher/classes/CustomExceptions.java

@@ -0,0 +1,6 @@
+package io.capawesome.capacitorjs.plugins.applauncher.classes;
+
+public class CustomExceptions {
+
+    public static final CustomException URL_MISSING = new CustomException(null, "url must be provided.");
+}

package/android/src/main/java/io/capawesome/capacitorjs/plugins/applauncher/classes/options/CanOpenUrlOptions.java

@@ -0,0 +1,24 @@
+package io.capawesome.capacitorjs.plugins.applauncher.classes.options;
+
+import androidx.annotation.NonNull;
+import com.getcapacitor.PluginCall;
+import io.capawesome.capacitorjs.plugins.applauncher.classes.CustomExceptions;
+
+public class CanOpenUrlOptions {
+
+    @NonNull
+    private final String url;
+
+    public CanOpenUrlOptions(@NonNull PluginCall call) throws Exception {
+        String url = call.getString("url");
+        if (url == null) {
+            throw CustomExceptions.URL_MISSING;
+        }
+        this.url = url;
+    }
+
+    @NonNull
+    public String getUrl() {
+        return url;
+    }
+}

package/android/src/main/java/io/capawesome/capacitorjs/plugins/applauncher/classes/options/OpenUrlOptions.java

@@ -0,0 +1,24 @@
+package io.capawesome.capacitorjs.plugins.applauncher.classes.options;
+
+import androidx.annotation.NonNull;
+import com.getcapacitor.PluginCall;
+import io.capawesome.capacitorjs.plugins.applauncher.classes.CustomExceptions;
+
+public class OpenUrlOptions {
+
+    @NonNull
+    private final String url;
+
+    public OpenUrlOptions(@NonNull PluginCall call) throws Exception {
+        String url = call.getString("url");
+        if (url == null) {
+            throw CustomExceptions.URL_MISSING;
+        }
+        this.url = url;
+    }
+
+    @NonNull
+    public String getUrl() {
+        return url;
+    }
+}

package/android/src/main/java/io/capawesome/capacitorjs/plugins/applauncher/classes/results/CanOpenUrlResult.java

@@ -0,0 +1,22 @@
+package io.capawesome.capacitorjs.plugins.applauncher.classes.results;
+
+import androidx.annotation.NonNull;
+import com.getcapacitor.JSObject;
+import io.capawesome.capacitorjs.plugins.applauncher.interfaces.Result;
+
+public class CanOpenUrlResult implements Result {
+
+    private final boolean value;
+
+    public CanOpenUrlResult(boolean value) {
+        this.value = value;
+    }
+
+    @Override
+    @NonNull
+    public JSObject toJSObject() {
+        JSObject result = new JSObject();
+        result.put("value", value);
+        return result;
+    }
+}

package/android/src/main/java/io/capawesome/capacitorjs/plugins/applauncher/classes/results/OpenUrlResult.java

@@ -0,0 +1,22 @@
+package io.capawesome.capacitorjs.plugins.applauncher.classes.results;
+
+import androidx.annotation.NonNull;
+import com.getcapacitor.JSObject;
+import io.capawesome.capacitorjs.plugins.applauncher.interfaces.Result;
+
+public class OpenUrlResult implements Result {
+
+    private final boolean completed;
+
+    public OpenUrlResult(boolean completed) {
+        this.completed = completed;
+    }
+
+    @Override
+    @NonNull
+    public JSObject toJSObject() {
+        JSObject result = new JSObject();
+        result.put("completed", completed);
+        return result;
+    }
+}

package/android/src/main/java/io/capawesome/capacitorjs/plugins/applauncher/interfaces/Callback.java

@@ -0,0 +1,5 @@
+package io.capawesome.capacitorjs.plugins.applauncher.interfaces;
+
+public interface Callback {
+    void error(Exception exception);
+}

package/android/src/main/java/io/capawesome/capacitorjs/plugins/applauncher/interfaces/NonEmptyResultCallback.java

@@ -0,0 +1,7 @@
+package io.capawesome.capacitorjs.plugins.applauncher.interfaces;
+
+import androidx.annotation.NonNull;
+
+public interface NonEmptyResultCallback<T extends Result> extends Callback {
+    void success(@NonNull T result);
+}

package/android/src/main/java/io/capawesome/capacitorjs/plugins/applauncher/interfaces/Result.java

@@ -0,0 +1,7 @@
+package io.capawesome.capacitorjs.plugins.applauncher.interfaces;
+
+import com.getcapacitor.JSObject;
+
+public interface Result {
+    JSObject toJSObject();
+}