Flutter Course, Implementing Login Functionality 16.5

In this article, we will explore in detail how to implement a login feature using the Flutter framework. The login feature is a core element of the user authentication process and is essential in many applications. Properly implementing the login feature plays a significant role in enhancing user experience and strengthening security.

1. Overview of Flutter and Login Feature

Flutter is a UI toolkit developed by Google, enabling the creation of beautiful and fast applications for both iOS and Android platforms from a single codebase. In particular, Flutter’s widget-based architecture helps to easily build user interfaces and effectively improve user experiences.

2. Reasons for Needing a Login Feature

  • Security: A login process is necessary to protect user data and prevent unauthorized access.
  • Personalization: When users log in, the user experience can be personalized, and persistent data storage becomes possible.
  • Data Management: The login feature allows administrators to efficiently collect and manage user data.

3. Project Setup

First, you need to check if the Flutter environment is installed. If the Flutter SDK is installed, you can create a new Flutter project using the command below.

flutter create login_example

Navigate to the project folder.

cd login_example

4. Adding Required Packages

To implement the login feature, you need to add the http package to manage HTTP requests. Additionally, you might need the provider package for form validation. Open the pubspec.yaml file and add the packages below:

dependencies:
  flutter:
    sdk: flutter
  http: ^0.13.3
  provider: ^5.0.0

Run the command below to apply the changes.

flutter pub get

5. Building Basic UI

Now, let’s build the basic UI for the login screen. Please write the following code in the lib/main.dart file.

import 'package:flutter/material.dart';

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

class MyApp extends StatelessWidget {
  @override
  Widget build(BuildContext context) {
    return MaterialApp(
      title: 'Login Example',
      theme: ThemeData(
        primarySwatch: Colors.blue,
      ),
      home: LoginPage(),
    );
  }
}

class LoginPage extends StatefulWidget {
  @override
  _LoginPageState createState() => _LoginPageState();
}

class _LoginPageState extends State {
  final TextEditingController _emailController = TextEditingController();
  final TextEditingController _passwordController = TextEditingController();

  void _login() {
    // Login feature implementation is planned
  }

  @override
  Widget build(BuildContext context) {
    return Scaffold(
      appBar: AppBar(
        title: Text('Login Page'),
      ),
      body: Padding(
        padding: const EdgeInsets.all(16.0),
        child: Column(
          mainAxisAlignment: MainAxisAlignment.center,
          children: [
            TextField(
              controller: _emailController,
              decoration: InputDecoration(
                labelText: 'Email',
                border: OutlineInputBorder(),
              ),
            ),
            SizedBox(height: 16.0),
            TextField(
              controller: _passwordController,
              decoration: InputDecoration(
                labelText: 'Password',
                border: OutlineInputBorder(),
              ),
              obscureText: true,
            ),
            SizedBox(height: 16.0),
            ElevatedButton(
              onPressed: _login,
              child: Text('Login'),
            ),
          ],
        ),
      ),
    );
  }
}

6. Implementing Login Functionality

We will explore how to handle user login information in a mobile application and how to request that information from a server. Add the following code to the _login method:

import 'dart:convert';
import 'package:http/http.dart' as http;

void _login() async {
  String email = _emailController.text;
  String password = _passwordController.text;

  // Sending POST request to the server
  final response = await http.post(
    Uri.parse('https://example.com/api/login'),
    headers: {
      'Content-Type': 'application/json',
    },
    body: jsonEncode({
      'email': email,
      'password': password,
    }),
  );

  if (response.statusCode == 200) {
    // Login successful
    final data = jsonDecode(response.body);
    // Handle user information (e.g., save token)
    print('Login successful: ${data['token']}');
  } else {
    // Login failed
    print('Login failed: ${response.body}');
  }
}

7. Error Handling and User Feedback

If the login fails, provide an appropriate error message to the user. You can use the alert dialog box to display an error message. You can add the following code to show a message upon login failure:

if (response.statusCode != 200) {
  _showErrorDialog('Login failed. Please check your email or password.');
}

void _showErrorDialog(String message) {
  showDialog(
    context: context,
    builder: (ctx) => AlertDialog(
      title: Text('Error'),
      content: Text(message),
      actions: [
        TextButton(
          onPressed: () => Navigator.of(ctx).pop(),
          child: Text('OK'),
        ),
      ],
    ),
  );
}

8. Adding Form Validation

It is advisable to add field validation to ensure that users enter valid email and password. You can validate input using Flutter’s Form and TextFormField widgets.

final _formKey = GlobalKey();

@override
Widget build(BuildContext context) {
  return Form(
    key: _formKey,
    child: Column(
      ...
      children: [
        TextFormField(
          controller: _emailController,
          validator: (value) {
            if (value == null || value.isEmpty) {
              return 'Please enter your email.';
            }
            return null;
          },
          ...
        ),
        TextFormField(
          controller: _passwordController,
          validator: (value) {
            if (value == null || value.isEmpty) {
              return 'Please enter your password.';
            }
            return null;
          },
          ...
        ),
        ElevatedButton(
          onPressed: () {
            if (_formKey.currentState!.validate()) {
              _login();
            }
          },
          child: Text('Login'),
        ),
      ],
    ),
  );
}

9. Session Management

To manage the user’s session after login, you can store the token of the logged-in user in local storage. Using the shared_preferences package allows for easy storage. Implement session management as follows:

import 'package:shared_preferences/shared_preferences.dart';

void _login() async {
  // ... existing code omitted ...
  
  if (response.statusCode == 200) {
    final data = jsonDecode(response.body);
    // Save token
    SharedPreferences prefs = await SharedPreferences.getInstance();
    await prefs.setString('token', data['token']);
    print('Login successful: ${data['token']}');
  }

10. Implementing Logout Functionality

Add a logout feature so that users can log out. During logout, end the session and remove the stored token.

void _logout() async {
  SharedPreferences prefs = await SharedPreferences.getInstance();
  await prefs.remove('token');
  print('Logged out successfully.');
}

11. Additional Security Considerations

When implementing the login feature, consider the following security principles:

  • HTTPS: Login requests should always use HTTPS protocol for encryption.
  • Password Storage: User passwords should be stored encrypted and should not be exposed directly.
  • Two-Factor Authentication: Consider implementing Two-Factor Authentication (MFA) for additional security.

12. Conclusion

In this tutorial, we explored in detail how to implement a login feature using Flutter. User authentication is an important part of applications and should be designed with security and user experience in mind. Built on the login feature, we hope to create applications that manage user data securely and efficiently.

We will cover more Flutter-related topics in future tutorials, so please stay tuned. Thank you!