Flutter Azure AD认证插件flutter_bootstrap_aad的使用

Flutter Azure AD认证插件flutter_bootstrap_aad的使用

flutter_bootstrap_aad 是一个用于在 Flutter 中实现响应式布局的插件。它部分实现了 Bootstrap 的网格系统。

Warning - 这个插件可能会被移除，如果原始插件的更改被批准。

开始使用

首先，你需要在你的 Flutter 项目中添加 flutter_bootstrap_aad 依赖项：

dependencies:
  flutter_bootstrap_aad: "^1.0.0-null-safety"

然后运行 flutter packages upgrade 或者在 IntelliJ 中更新你的包。

在 Dart 代码中，导入该库：

import 'package:flutter_bootstrap/flutter_bootstrap_aad.dart';

文档

该插件暴露了四个新的 Widget:

  • BootstrapContainer
  • BootstrapRow
  • BootstrapCol
  • BootstrapVisibility

还有一些辅助方法:

  • bootstrapGridParameters
  • bootstrapPrefixBasedOnWidth
  • bootstrapMaxWidthNonFluid
  • bootStrapValueBasedOnSize

它实现了以下 Bootstrap4 特性:

  • .container
  • .container-fluid
  • .row
  • .col-*, .col-sm-*, .col-md-*, .col-lg-*, .col-xl-*
  • .offset-*, .offset-sm-*, .offset-md-*, .offset-lg-*, .offset-xl-*
  • .order-*, .order-sm-*, .order-md-*, .order-lg-*, .order-xl-*
  • 基于设备宽度和列定义的条件可见性

完整的文档和示例可以在我的网站上找到。

示例

一个示例可以在 example 文件夹中找到。你可以查看它。

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

void main() => runApp(Application());

class Application extends StatelessWidget {
  [@override](/user/override)
  Widget build(BuildContext context) {
    return MaterialApp(
      title: 'flutter_bootstrap_demo',
      home: DemoPage(),
    );
  }
}

class DemoPage extends StatefulWidget {
  [@override](/user/override)
  _DemoPageState createState() => _DemoPageState();
}

class _DemoPageState extends State<DemoPage> {
  [@override](/user/override)
  void initState() {
    super.initState();
    bootstrapGridParameters(
      gutterSize: 30,
    );
  }

  [@override](/user/override)
  Widget build(BuildContext context) {
    return Scaffold(
      appBar: AppBar(
        title: Text('flutter_bootstrap_demo', style: TextStyle(color: Colors.black)),
        backgroundColor: Colors.white,
      ),
      body: SingleChildScrollView(
        child: BootstrapContainer(
          fluid: true,
          decoration: BoxDecoration(color: Colors.blue),
          children: [
            BootstrapContainer(
              fluid: false,
              decoration: BoxDecoration(color: Colors.white),
              padding: const EdgeInsets.only(top: 50),
              children: <Widget>[
                BootstrapRow(
                  height: 60,
                  children: <BootstrapCol>[
                    BootstrapCol(
                      sizes: 'col-6',
                      child: ContentWidget(
                        text: 'col 1 of 2',
                        color: Colors.red,
                      ),
                    ),
                    BootstrapCol(
                      sizes: 'col-6',
                      child: ContentWidget(
                        text: 'col 2 of 2',
                        color: Colors.red,
                      ),
                    ),
                  ],
                ),
                SizedBox(height: 8),
                BootstrapRow(
                  height: 60,
                  children: <BootstrapCol>[
                    BootstrapCol(
                      sizes: 'col-3',
                      child: ContentWidget(
                        text: 'col 1 of 3',
                        color: Colors.green,
                      ),
                    ),
                    BootstrapCol(
                      sizes: 'col-6',
                      child: ContentWidget(
                        text: 'col 2 of 3 (wider)',
                        color: Colors.red,
                      ),
                    ),
                    BootstrapCol(
                      sizes: 'col-3',
                      child: ContentWidget(
                        text: 'col 3 of 3',
                        color: Colors.green,
                      ),
                    ),
                  ],
                ),
                SizedBox(height: 8),
                Divider(),
                BootstrapRow(
                  height: 120,
                  children: <BootstrapCol>[
                    BootstrapCol(
                      sizes: 'col-12 col-md-8',
                      child: ContentWidget(
                        text: 'col-12 col-md-8',
                        color: Colors.yellow,
                      ),
                    ),
                    BootstrapCol(
                      sizes: 'col-6 col-md-4',
                      child: ContentWidget(
                        text: 'col-6 col-md-4',
                        color: Colors.green,
                      ),
                    ),
                  ],
                ),
                Divider(),
                BootstrapRow(
                  height: 120,
                  children: <BootstrapCol>[
                    BootstrapCol(
                      sizes: 'col-9',
                      child: ContentWidget(
                        text: 'col-9',
                        color: Colors.yellow,
                      ),
                    ),
                    BootstrapCol(
                      sizes: 'col-4',
                      child: ContentWidget(
                        text:
                            'col-4\nSince 9+4 = 13 &amp; 13 &gt; 2, this 4-columns gets wrapped onto a new line',
                        color: Colors.green,
                      ),
                    ),
                  ],
                ),
                Divider(),
                BootstrapRow(
                  height: 60,
                  children: <BootstrapCol>[
                    BootstrapCol(
                      sizes: 'col-md-4',
                      child: ContentWidget(
                        text: 'col-md-8',
                        color: Colors.red,
                      ),
                    ),
                    BootstrapCol(
                      sizes: 'col-md-4',
                      offsets: 'offset-md-4',
                      child: ContentWidget(
                        text: 'col-md-4 offset-md-4',
                        color: Colors.green,
                      ),
                    ),
                  ],
                ),
                BootstrapRow(
                  height: 60,
                  children: <BootstrapCol>[
                    BootstrapCol(
                      sizes: 'col-md-3',
                      offsets: 'offset-md-3',
                      child: ContentWidget(
                        text: 'col-md-3 offset-md-3',
                        color: Colors.yellow,
                      ),
                    ),
                    BootstrapCol(
                      sizes: 'col-md-3',
                      offsets: 'offset-md-3',
                      child: ContentWidget(
                        text: 'col-md-3 offset-md-3',
                        color: Colors.purple,
                      ),
                    ),
                  ],
                ),
                BootstrapRow(
                  height: 60,
                  children: <BootstrapCol>[
                    BootstrapCol(
                      sizes: 'col-md-6',
                      offsets: 'offset-md-3',
                      child: ContentWidget(
                        text: 'col-md-6 offset-md-3',
                        color: Colors.yellow,
                      ),
                    ),
                  ],
                ),
                Divider(),
                BootstrapRow(
                  height: 200,
                  children: <BootstrapCol>[
                    BootstrapCol(
                      sizes: 'col-12 col-md-8',
                      orders:
                          'order-2 order-sm-2 order-md-1 order-lg-1 order-xl-1',
                      child: ContentWidget(
                        text: 'col-12 col-md-8 order2(xs,sm)',
                        color: Colors.red,
                      ),
                    ),
                    BootstrapCol(
                      sizes: 'col-12 col-sm-12 col-md-6 col-lg-3 col-xl-3',
                      orders:
                          'order-1 order-sm-1 order-md-2 order-lg-2 order-xl-2',
                      child: ContentWidget(
                        text: 'col 2 order1(xs,sm)',
                        color: Colors.green,
                      ),
                    ),
                    BootstrapCol(
                      sizes: 'col-12 col-sm-12 col-md-6 col-lg-3 col-xl-3',
                      offsets:
                          'offset-0 offset-sm-0 offset-md-2 offset-lg-4 offset-xl-5',
                      orders:
                          'order-3 order-sm-3 order-md-3 order-lg-3 order-xl-3',
                      child: ContentWidget(
                        text: 'col 3',
                        color: Colors.yellow,
                      ),
                    ),
                    BootstrapCol(
                      sizes: 'col-12 col-sm-12 col-md-6 col-lg-3 col-xl-3',
                      orders:
                          'order-4 order-sm-4 order-md-4 order-lg-4 order-xl-4',
                      invisibleForSizes: 'sm xl',
                      child: ContentWidget(
                        text: 'invisible for sm and xl',
                        color: Colors.purple,
                      ),
                    ),
                  ],
                ),
              ],
            ),
          ],
        ),
      ),
    );
  }
}

class ContentWidget extends StatelessWidget {
  const ContentWidget({
    Key? key,
    this.text,
    this.color,
  }) : super(key: key);

  final String? text;
  final Color? color;

  [@override](/user/override)
  Widget build(BuildContext context) {
    return Container(
      height: 50,
      color: color,
      child: Text(text!),
    );
  }
}

更多关于Flutter Azure AD认证插件flutter_bootstrap_aad的使用的实战教程也可以访问 https://www.itying.com/category-92-b0.html

1 回复

更多关于Flutter Azure AD认证插件flutter_bootstrap_aad的使用的实战系列教程也可以访问 https://www.itying.com/category-92-b0.html


在Flutter应用中使用flutter_bootstrap_aad插件进行Azure AD（Azure Active Directory）认证的步骤如下。该插件简化了与Azure AD的集成，使开发者可以轻松地在Flutter应用中实现身份验证。

1. 添加依赖

首先，在pubspec.yaml文件中添加flutter_bootstrap_aad依赖：

dependencies:
  flutter:
    sdk: flutter
  flutter_bootstrap_aad: ^1.0.0  # 请确认使用最新版本

然后运行flutter pub get来安装依赖。

2. 配置 Azure AD

在Azure门户中创建一个应用注册，并配置以下内容：

  • 重定向 URI: 设置为msal<Your_Client_ID>://auth（例如：msal12345678-1234-1234-1234-123456789012://auth）。
  • 权限: 确保你为应用配置了必要的API权限。

记录下Client ID、Tenant ID和Redirect URI，这些信息需要在Flutter应用中使用。

3. 初始化插件

在Flutter应用中初始化flutter_bootstrap_aad插件。

import 'package:flutter_bootstrap_aad/flutter_bootstrap_aad.dart';

void main() async {
  WidgetsFlutterBinding.ensureInitialized();
  
  await FlutterBootstrapAad.initialize(
    clientId: 'YOUR_CLIENT_ID',
    tenantId: 'YOUR_TENANT_ID',
    redirectUri: 'YOUR_REDIRECT_URI',
  );
  
  runApp(MyApp());
}

4. 实现登录逻辑

在应用中添加登录按钮，并调用login方法进行认证。

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

class MyApp extends StatelessWidget {
  @override
  Widget build(BuildContext context) {
    return MaterialApp(
      home: Scaffold(
        appBar: AppBar(
          title: Text('Azure AD Authentication'),
        ),
        body: Center(
          child: ElevatedButton(
            onPressed: () async {
              try {
                final result = await FlutterBootstrapAad.login();
                if (result.isLoggedIn) {
                  // 用户登录成功
                  print('User logged in: ${result.account?.username}');
                } else {
                  // 用户未登录或登录失败
                  print('Login failed');
                }
              } catch (e) {
                print('Error during login: $e');
              }
            },
            child: Text('Login with Azure AD'),
          ),
        ),
      ),
    );
  }
}

5. 处理登录结果

登录成功后，你可以通过result.account获取用户的详细信息。你可以使用这些信息来个性化用户体验或调用受保护的API。

6. 注销

你还可以通过调用logout方法来注销用户：

await FlutterBootstrapAad.logout();

7. 处理身份验证回调

确保在你的AndroidManifest.xml和Info.plist文件中正确配置了回调URL，以处理身份验证的重定向。

Android

在android/app/src/main/AndroidManifest.xml中添加以下内容：

<activity android:name="com.microsoft.identity.client.BrowserTabActivity">
    <intent-filter>
        <action android:name="android.intent.action.VIEW" />
        <category android:name="android.intent.category.DEFAULT" />
        <category android:name="android.intent.category.BROWSABLE" />
        <data android:scheme="msalYOUR_CLIENT_ID" android:host="auth" />
    </intent-filter>
</activity>

iOS

在ios/Runner/Info.plist中添加以下内容：

<key>CFBundleURLTypes</key>
<array>
    <dict>
        <key>CFBundleURLSchemes</key>
        <array>
            <string>msalYOUR_CLIENT_ID</string>
        </array>
    </dict>
</array>

8. 处理令牌刷新

flutter_bootstrap_aad插件会自动处理令牌刷新，但你可以在需要时手动调用acquireTokenSilent方法来获取新的访问令牌。

final result = await FlutterBootstrapAad.acquireTokenSilent();
if (result.isLoggedIn) {
  // 令牌刷新成功
  print('New token: ${result.accessToken}');
} else {
  // 令牌刷新失败
  print('Token refresh failed');
}
回到顶部