Running Services Monitor

To add support for a new language, you must update both the Flutter localization files and the Android resource configuration.

1. Flutter Localization

• Create a new app_<localeName>.arb file in lib/l10n/ (e.g., app_es.arb for Spanish).
• Translate all fields from the base app_en.arb file, ensuring keys remain unchanged.
• Register the new language in lib/core/constants.dart within the languages list:

static const List<Lang> languages = [
  Lang(Locale('en'), 'English'),
  Lang(Locale('bn'), 'বাংলা'),
  Lang(Locale('zh'), '简体中文'),
  Lang(Locale('<localeName>'), '<Native Language Name>'), // Add your new entry here
];

2. Android Configuration

Add the new locale to android/app/src/main/res/xml/locales_config.xml:

<locale android:name="<localeName>" />

3. Generate Files

Run these commands in the project root to apply changes:

flutter gen-l10n
dart run build_runner build --delete-conflicting-outputs

static const List<Lang> languages = [
  Lang(Locale('en'), 'English'),
  Lang(Locale('bn'), 'বাংলা'),
  Lang(Locale('zh'), '简体中文'),
  Lang(Locale('<localeName>'), '<Native Language Name>'), // Add here
];

To build the project locally, ensure you have Flutter and Dart installed. Follow these steps:

1. Clone the repository and navigate to the directory.
2. Fetch dependencies.
3. Generate necessary code (Freezed models and localization).
4. Run or build the application.

Available build targets:

• Debug: Run directly on a connected device.
• Release APK: A single universal APK.
• Split APK: Smaller APKs split per ABI.
• App Bundle: For Google Play Store distribution.

# Clone the repository
git clone https://github.com/biplobsd/running_services_monitor.git
cd running_services_monitor

# Get dependencies
flutter pub get

# Generate code (Freezed models and localization)
flutter gen-l10n
dart run build_runner build --delete-conflicting-outputs

# Run on connected device
flutter run

# Build release APK (universal)
flutter build apk --release

# Build release APK (split per ABI for smaller file sizes)
flutter build apk --release --split-per-abi

# Build App Bundle for Play Store
flutter build appbundle --release

The application entrypoint initializes several core systems:

• AppIconCache: Caches application icons.
• HydratedBloc: Sets up persistent storage for BLoC states using the application's documents directory.
• Dependency Injection: Calls configureDependencies() to register all required services and BLoCs.
• System UI: Configures an edge-to-edge display with transparent status and navigation bars.

Note: The initialization is wrapped in a try-catch block to prevent app crashes during early startup failures.

void main() async {
  try {
    WidgetsFlutterBinding.ensureInitialized();
    await AppIconCache.initialize();
    SystemChrome.setEnabledSystemUIMode(SystemUiMode.edgeToEdge);
    SystemChrome.setSystemUIOverlayStyle(
      const SystemUiOverlayStyle(
        statusBarColor: Colors.transparent,
        systemNavigationBarColor: Colors.transparent,
        systemNavigationBarDividerColor: Colors.transparent,
      ),
    );
    HydratedBloc.storage = await HydratedStorage.build(
      storageDirectory: HydratedStorageDirectory((await getApplicationDocumentsDirectory()).path),
    );

    configureDependencies();
    runApp(const MyApp());
  } catch (_) {}
}

The CustomScrollProvider is a widget used to manage a collection of CustomScrollController instances synchronized with a TabController. It is designed for scenarios where multiple scrollable views (one per tab) share a single parent ScrollController but need to be attached or detached dynamically based on the active tab to optimize performance or behavior.

To use it, wrap your tabbed content with CustomScrollProvider and provide the following:

• tabController: The TabController managing the tab state.
• parent: The primary ScrollController that the individual tab controllers will delegate to.
• child: The widget tree containing the tabs.

Inside the child tree, you can access the list of controllers using CustomScrollProviderData.of(context).

CustomScrollProvider(
  tabController: myTabController,
  parent: myParentScrollController,
  child: MyTabbedContentWidget(),
)

The CommandOutputHighlightedText widget is used to render command output text with support for search highlighting and automatic scrolling to the current match. It uses a monospace font and supports both vertical and horizontal scrolling to ensure long lines or large outputs are navigable.

Key Features

• Search Highlighting: Matches are highlighted with Colors.yellowAccent. The currently selected match (currentMatchIndex) is highlighted with Colors.orangeAccent and a bolder font weight.
• Auto-Scrolling: When the currentMatchIndex or the search query changes, the widget automatically animates the scrollController to bring the active match into view.
• Customizable Styling: You can control fontSize, textColor, and backgroundColor.
• Padding Control: Use scrollTopPadding and scrollLeftPadding to adjust the offset when the widget scrolls to a match.

CommandOutputHighlightedText(
  text: commandOutputString,
  searchQuery: currentSearchQuery,
  searchMatches: listOfMatchStartIndices,
  currentMatchIndex: activeMatchIndex,
  fontSize: 14.0,
  textColor: Colors.white,
  backgroundColor: Colors.black,
  scrollController: myScrollController,
  scrollTopPadding: 32,
  scrollLeftPadding: 24,
);