Installation Guide
Relevant source files
The following files were used as context for generating this wiki page:
Introduction
The fikak_app project is a Flutter-based mobile application designed for cross-platform deployment on Android and iOS. This guide provides the technical requirements and procedural steps necessary to set up the development environment, install dependencies, and build the application from source.
The installation process involves configuring the Flutter SDK, managing Dart packages via pubspec.yaml, and ensuring platform-specific configurations for Android and iOS are correctly applied to support the application's runtime requirements.
Environment Prerequisites
Before installing the application, the development environment must meet the requirements defined by the Flutter framework and project-specific configurations.
System Requirements
- Flutter SDK: The project is built using the Flutter framework.
- Dart SDK: Version constraints are defined in the project configuration.
- Android SDK: Required for building the
.apkor.aabfiles. - Xcode: Required for building and deploying to iOS devices or simulators.
Sources: pubspec.yaml:7-9, android/app/build.gradle:1-5
SDK Versioning
The project specifies a specific environment range for the Dart SDK to ensure compatibility with modern language features used in the codebase.
| Component | Required Version |
|---|---|
| Dart SDK | >=3.0.0 <4.0.0 |
| Flutter | >=3.0.0 |
Sources: pubspec.yaml:7-9
Installation Steps
1. Clone the Repository
Download the source code to your local machine using Git:
git clone https://github.com/BablAdm/fikak_app.git
cd fikak_app
Sources: README.md:1
2. Dependency Management
The application relies on several Flutter packages for its functionality. Use the Flutter CLI to fetch and install these dependencies as defined in pubspec.yaml.
flutter pub get
The core dependencies included in the project are:
flutter: The SDK itself.cupertino_icons: For iOS-style icons.
Sources: pubspec.yaml:26-31
3. Platform Configuration
Android Setup
The Android build configuration is managed through Gradle. Key parameters include the application ID and SDK versions.
- Application ID:
com.example.fikak_app - Minimum SDK Version:
21(Android 5.0) - Target SDK Version:
33(Android 13.0)
Sources: android/app/build.gradle:37-41
iOS Setup
For iOS, the application configuration is defined in the Info.plist file. This includes the display name and execution requirements.
- Bundle Name:
fikak_app - Minimum OS Version: Defined by Flutter standard (typically iOS 11.0 or higher).
Sources: ios/Runner/Info.plist:11-15
Build Pipeline
The following diagram illustrates the flow from source code to a running application.
The build process ensures that all Dart code is compiled and packaged with the necessary assets and platform-specific native code.
Sources: lib/main.dart:1-10, pubspec.yaml:1-20
Application Entry Point
Once the environment is set up and dependencies are installed, the application is launched via the main.dart file. This file initializes the Flutter framework and executes the root widget.
void main() {
runApp(const MyApp());
}
Sources: lib/main.dart:5-7
Summary
The installation of fikak_app requires a functional Flutter environment with Dart SDK version 3.0.0 or higher. By resolving dependencies through pubspec.yaml and configuring the Android and iOS build settings (SDK 33 for Android), developers can build and run the application across platforms. The process concludes with the execution of the main() function in lib/main.dart.