emenel/doomemacs
1
0
Fork 0
Code Issues Pull requests Projects Releases Packages Wiki Activity
doomemacs/modules/lang/dart/README.org
M. Yas. Davoodeh 2b47b1e99a Fixed issues addressed by @hlissner on #2549.
2020-03-16 00:02:16 +03:30

4.1 KiB
Raw Blame History

lang/dart

Description

Dart is a client-optimized language by Google for fast apps on any platform. It is fast and optimized for UI, Famous for the Flutter framework, also made by Google. Both Flutter and Dart are free and open-source.

Maintainers

This module has no dedicated maintainers.

Module Flags

The `dart` module wraps `dart-mode`, with LSP code completion for `.dart` files, syntax highlighting, etc. Included is a `+lsp` flag for enabling LSP features, and a `+flutter` flag for working with Flutter.

  • +lsp Will start LSP automatically in `dart-mode-hook`.
  • +flutter Adds the `flutter` package and some settings for Flutter development.

Plugins

Prerequisites

Make sure that the Dart SDK is on your `PATH`, and if using Flutter, make sure the Flutter binary is on your `PATH` as well.

Installing Dart SDK

Before starting note that Flutter SDK will have a version of Dart. Therefore, there is no need to install Dart. If you want to use Flutter just see the next part.

The stable version of the SDK is in most major distributions repositories. If you find it necessary to install any other version or build from source, please refer to the official website at: https://dart.dev/get-dart

On Debian (also Ubuntu and its derivations), you can simply install the SDK via:

sudo apt-get install dart

Or on Arch (and its derivations, like Manjaro), you can install it using:

sudo pacman -S dart

And finally in MacOS, the Homebrew can come in handy. If you have it installed just run:

brew tap dart-lang/dart
brew install dart#+END_SRC

Installing Flutter SDK

Due to complications with permissions, it is suggested not to use AUR or any automatic installation tools for Flutter SDK.

On any system just run the following commands to install Flutter, once you have met dependencies named on the site:

git clone https://github.com/flutter/flutter --branch stable # to download Flutter
export PATH="$PATH:$(pwd)/flutter/bin" # to add it to PATH
flutter doctor # for Dependency check and further instructions

Features

  • Syntax highlighting and formatting for `.dart` files provided by LSP
  • Emacs functions for running and debugging Flutter projects

Configuration

Dart & Flutter

On Linux, the installers for Dart and Flutter use the `/opt` directory, and this module assumes that. However, you may set `lsp-dart-sdk-dir` to your Dart install directory, if it differs, to make sure LSP can find the language server included with the Dart SDK.

Alternatively, these variables shouldn't be necessary if you just include Dart and Flutter on your `PATH` variable.

Android

You will also need to setup your system for Android development if you intend to use Flutter to develop mobile applications. Refer to your distributions package manager for details. In most distributions the `/opt/android-sdk` directory is used, and you might have to change some permissions in this directory since it's owned by root. The Arch Linux wiki has a great guide on this here.

Troubleshooting

See the configuration section for information on the binaries for Dart and Flutter. On new installs to the `/opt` directory, you will likely need to edit the permissions of the `/opt/dart-sdk` and `/opt/flutter` directories (not to mention the Android SDK, as discussed above).