Flutter URL启动管理插件enhanced_url_launcher_windows的使用

Flutter URL启动管理插件enhanced_url_launcher_windows的使用

url_launcher_windows 是 enhanced_url_launcher 插件的Windows实现。

使用

此包被推荐为官方支持的插件，因此您可以像平常一样直接使用 enhanced_url_launcher。当您这样做时，此包将自动包含在您的应用中，因此您无需将其添加到 pubspec.yaml 文件中。

但是，如果您导入此包以直接使用其API，则应像往常一样将其添加到您的 pubspec.yaml 文件中。

示例代码

以下是一个完整的示例，演示了如何使用 enhanced_url_launcher 插件来打开浏览器。

// Copyright 2013 The Flutter Authors. All rights reserved.
// Use of this source code is governed by a BSD-style license that can be
// found in the LICENSE file.

// ignore_for_file: public_member_api_docs

import 'dart:async';
import 'package:flutter/material.dart';
import 'package:enhanced_url_launcher_platform_interface/enhanced_url_launcher_platform_interface.dart';

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

class MyApp extends StatelessWidget {
  const MyApp({super.key});

  @override
  Widget build(BuildContext context) {
    return MaterialApp(
      title: 'URL Launcher',
      theme: ThemeData(
        primarySwatch: Colors.blue,
      ),
      home: const MyHomePage(title: 'URL Launcher'),
    );
  }
}

class MyHomePage extends StatefulWidget {
  const MyHomePage({super.key, required this.title});
  final String title;

  @override
  State<MyHomePage> createState() => _MyHomePageState();
}

class _MyHomePageState extends State<MyHomePage> {
  Future<void>? _launched;

  Future<void> _launchInBrowser(String url) async {
    // 检查是否可以打开指定的URL
    if (await UrlLauncherPlatform.instance.canLaunch(url)) {
      // 打开URL
      await UrlLauncherPlatform.instance.launch(
        url,
        // 配置选项
        useSafariVC: false,
        useWebView: false,
        enableJavaScript: false,
        enableDomStorage: false,
        universalLinksOnly: false,
        headers: <String, String>{},
      );
    } else {
      // 如果无法打开URL，抛出异常
      throw Exception('Could not launch $url');
    }
  }

  Widget _launchStatus(BuildContext context, AsyncSnapshot<void> snapshot) {
    // 如果有错误发生，显示错误信息
    if (snapshot.hasError) {
      return Text('Error: ${snapshot.error}');
    } else {
      // 否则，返回一个空的文本
      return const Text('');
    }
  }

  @override
  Widget build(BuildContext context) {
    // 要打开的URL
    const String toLaunch = 'https://www.cylog.org/headers/';
    return Scaffold(
      appBar: AppBar(
        title: Text(widget.title),
      ),
      body: ListView(
        children: [
          // 显示要打开的URL
          Column(
            mainAxisAlignment: MainAxisAlignment.center,
            children: [
              const Padding(
                padding: EdgeInsets.all(16.0),
                child: Text(toLaunch),
              ),
              // 添加一个按钮，点击后尝试打开URL
              ElevatedButton(
                onPressed: () => setState(() {
                  _launched = _launchInBrowser(toLaunch);
                }),
                child: const Text('Launch in browser'),
              ),
              const Padding(padding: EdgeInsets.all(16.0)),
              // 显示打开URL的结果
              FutureBuilder<void>(
                future: _launched,
                builder: _launchStatus,
              ),
            ],
          ),
        ],
      ),
    );
  }
}

说明

1. 导入必要的库：

   import 'dart:async';
   import 'package:flutter/material.dart';
   import 'package:enhanced_url_launcher_platform_interface/enhanced_url_launcher_platform_interface.dart';
   

2. 定义主应用：

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

3. 定义主界面：

   class MyApp extends StatelessWidget {
     const MyApp({super.key});
   
     @override
     Widget build(BuildContext context) {
       return MaterialApp(
         title: 'URL Launcher',
         theme: ThemeData(
           primarySwatch: Colors.blue,
         ),
         home: const MyHomePage(title: 'URL Launcher'),
       );
     }
   }
   

4. 定义主页状态：

   class _MyHomePageState extends State<MyHomePage> {
     Future<void>? _launched;
   
     Future<void> _launchInBrowser(String url) async {
       if (await UrlLauncherPlatform.instance.canLaunch(url)) {
         await UrlLauncherPlatform.instance.launch(
           url,
           useSafariVC: false,
           useWebView: false,
           enableJavaScript: false,
           enableDomStorage: false,
           universalLinksOnly: false,
           headers: <String, String>{},
         );
       } else {
         throw Exception('Could not launch $url');
       }
     }
   
     Widget _launchStatus(BuildContext context, AsyncSnapshot<void> snapshot) {
       if (snapshot.hasError) {
         return Text('Error: ${snapshot.error}');
       } else {
         return const Text('');
       }
     }
   
     @override
     Widget build(BuildContext context) {
       const String toLaunch = 'https://www.cylog.org/headers/';
       return Scaffold(
         appBar: AppBar(
           title: Text(widget.title),
         ),
         body: ListView(
           children: [
             Column(
               mainAxisAlignment: MainAxisAlignment.center,
               children: [
                 const Padding(
                   padding: EdgeInsets.all(16.0),
                   child: Text(toLaunch),
                 ),
                 ElevatedButton(
                   onPressed: () => setState(() {
                     _launched = _launchInBrowser(toLaunch);
                   }),
                   child: const Text('Launch in browser'),
                 ),
                 const Padding(padding: EdgeInsets.all(16.0)),
                 FutureBuilder<void>(
                   future: _launched,
                   builder: _launchStatus,
                 ),
               ],
             ),
           ],
         ),
       );
     }
   }