Buscar pacotes, repositórios e categorias de apps

Detalhes do pacotev4.0.4

external_app_launcher

Um plug-in do Flutter que ajuda você a abrir outro aplicativo do seu aplicativo

AndroidiOS
Downloads em 30 dias
86,5 mil
Curtidas
372
Pontos Pub
150

Instalar pacote

flutter pub add external_app_launcher

Visão geral do pacote

Orientação gerada a partir de informações públicas. Apenas para referência.

O pacote external_app_launcher é um plugin Flutter que permite que aplicativos abram outros aplicativos instalados em dispositivos Android e iOS. Ele simplifica o lançamento de aplicativos externos usando seus nomes de pacote ou URLs, suportando links profundos e intenções específicas do aplicativo. Isso é particularmente útil para integração com aplicativos nativos como mapas, mensagens ou plataformas sociais. O plugin funciona perfeitamente em ambas as principais plataformas móveis e é ideal para compartilhar conteúdo ou redirecionar usuários para serviços de terceiros. Requer configuração mínima e fornece funcionalidade confiável entre plataformas.

Casos de uso

  • Abrir aplicativos de mapas a partir de dados de localização
  • Redirecionando usuários para aplicativos de mensagens
  • Iniciando aplicativos de mídia social para compartilhar
  • Integração com aplicativos de pagamento ou e-mail
  • Habilitar links profundos para telas específicas do aplicativo

Principais recursos

  • Suporta plataformas Android e iOS
  • API simples para lançar aplicativos externos
  • Gerencia nomes de pacotes e URLs
  • Habilita o link profundo
  • Compatibilidade multiplataforma

Indicado para

  • Aplicativos que precisam de redirecionamento de aplicativo
  • Recursos de compartilhamento ou integração
  • Navegação para serviços de terceiros
  • Desenvolvedores de ferramentas úteis
  • Projetos que exigem tratamento de intenção

Considerações

  • Requer nomes de pacotes ou URLs corretos
  • Pode falhar se o aplicativo de destino não estiver instalado
  • Controle limitado sobre o comportamento do aplicativo iniciado
  • Permissões podem ser necessárias em alguns dispositivos
  • Depende da implementação específica da plataforma

README original

Snapshot do README original do repositório-fonte vinculado. Consulte o repositório para o conteúdo mais recente.

Overview

A Flutter plugin which helps you to open another app from your app. The package asks you for four parameters out of which two are mandatory.

Getting Started

1. Add package to your project

Complete description to add this package to your project can be found here.

2. To setup native performance for the application in order to launch external apps

For opening apps in android

For opening an external app from your app in android, you need provide packageName of the app.

If the plugin finds the app in the device, it will be launched. But if the app is not installed in the device then it leads the user to playstore link of the app.

⚠️ Android 11+ Package Visibility (Required)

On Android 11 (API 30) and above, the OS restricts which packages your app can query. If you do not declare the target package in your AndroidManifest.xml, both isAppInstalled() and openApp() will silently behave as if the app is not installed — even if it is.

You must add a <queries> block above the <application> tag in your android/app/src/main/AndroidManifest.xml for every package you want to interact with:

<manifest xmlns:android="http://schemas.android.com/apk/res/android">

    <queries>
        <!-- Declare every package you want to check or launch -->
        <package android:name="net.pulsesecure.pulsesecure" />
        <package android:name="us.zoom.videomeetings" />
        <package android:name="com.instagram.android" />
        <!-- Add more packages as needed -->
    </queries>

    <application ...>
        ...
    </application>

</manifest>

Note: Without this declaration, isAppInstalled('us.zoom.videomeetings') will always return false on Android 11+ even if Zoom is installed.

Tip: If you want to query all apps (not recommended for privacy), you can use the QUERY_ALL_PACKAGES permission instead, but this requires justification when publishing to the Play Store.

⚠️ Android 10+ Background Activity Start Limits

On Android 10 (API 29) and above, the OS restricts apps from starting activities from the background (e.g. from background services, background broadcast receivers, or background notifications). Attempting to do so will result in a SecurityException being caught and a descriptive error message being returned.

If you need to launch external apps from background states, please review Android's guide on allowed exceptions for background starts.

Demo

In iOS, for opening an external app from your app, you need to provide the URL scheme of the target app.

⚠️ iOS Platform Limitation: URL Schemes Required

Due to iOS security sandboxing, it is impossible to launch or query external apps using package names/bundle IDs or without a registered custom URL scheme (e.g., instagram://).

  • You must obtain the target app's custom URL scheme.
  • If your app's deployment target is iOS 9 or above, you must also whitelist the scheme in your Info.plist under LSApplicationQueriesSchemes (see below).

To know more about URLScheme refer to this Link

Alternatively, you can launch Safari directly to open a website by calling:

await LaunchApp.openSafari(url: 'https://www.apple.com');

Or by passing the web URL directly to the iosUrlScheme parameter in openApp.

To open a URL in Google Chrome on both platforms:

await LaunchApp.openUrlInChrome(url: 'https://www.example.com');

On Android this targets the com.android.chrome package. On iOS it converts https:// → googlechromes://.

To target any specific browser on Android, or use a custom iOS scheme:

await LaunchApp.openUrlInBrowser(
  url: 'https://www.example.com',
  androidBrowserPackage: 'org.mozilla.firefox', // Firefox on Android
  iosUrlScheme: 'firefox://open-url?url=https://www.example.com', // Firefox on iOS
);

If the specified browser is not installed on Android, the system default browser is used as fallback.

If your deployment target is greater than or equal to 9, then you also need to update external app information in Info.plist.

<key>LSApplicationQueriesSchemes</key>
<array>
  <string>pulsesecure</string> // url scheme name of the app
</array>

But unlike in Android, it will not navigate to store (appStore) if app is not found in the device.

For doing so you need to provide the iTunes link of the app.

Demo

Implementation

Apart from opening an external app, this package can also be used to check whether an app is installed in the device or not.

This can done by simply calling the function isAppInstalled

await LaunchApp.isAppInstalled(
  androidPackageName: 'net.pulsesecure.pulsesecure'
  iosUrlScheme: 'pulsesecure://'
);

This returns true and false based on the fact whether app is installed or not.

Code Illustration

import 'package:flutter/material.dart';
import 'package:external_app_launcher/external_app_launcher.dart';

void main() {
  runApp(MyApp());
}

class MyApp extends StatefulWidget {
  @override
  _MyAppState createState() => _MyAppState();
}

class _MyAppState extends State<MyApp> {
  @override
  void initState() {
    super.initState();
  }

  Color containerColor = Colors.red;

  @override
  Widget build(BuildContext context) {
    return MaterialApp(
      home: Scaffold(
        appBar: AppBar(
          title: const Text('Plugin example app'),
        ),
        body: Center(
          child: Container(
            height: 50,
            width: 150,
            child: RaisedButton(
              color: Colors.blue,
              onPressed: () async {
                await LaunchApp.openApp(
                  androidPackageName: 'net.pulsesecure.pulsesecure',
                  iosUrlScheme: 'pulsesecure://',
                  appStoreLink: 'itms-apps://itunes.apple.com/us/app/pulse-secure/id945832041',
                  // openStore: false
                );

                // Enter the package name of the App you want to open and for iOS add the URLscheme to the Info.plist file.
                // The `openStore` argument decides whether the app redirects to PlayStore or AppStore.
                // For testing purpose you can enter com.instagram.android
              },
              child: Container(
                child: Center(
                  child: Text("Open",
                    textAlign: TextAlign.center,
                  ),
                ))),
          ),
        ),
      ),
    );
  }
}

Categorias

Repositório-fonte

Projetos que usam este pacote