Dart Server开发环境搭建及新建运行项目

川长思鸟来 2022-03-08 10:38 653阅读 0赞

### Dart Server开发环境搭建及新建运行项目 ###

*   *  开发环境的搭建
     *   *  1. 下载Dart SDK
         *  2. 下载开发工具
         *  3. 创建Dart Server项目

--------------------

Dart除了可以使用Flutter进行移动应用开发、Web开发外，还可以进行服务器端开发，也就是后端开发。如建立后端服务、编写接口、查询数据库、任务调度等等后端、服务器端的工作它都可以实现。接下来，我们就开始Dart Server开发的准备工作吧。本文将主要介绍：

>  *  Dart Server开发环境配置
>  *  Dart Server开发工具安装
>  *  Dart Server开发的两种创建Server项目的方式
>  *  运行Dart Server项目

--------------------

## 开发环境的搭建 ##

Dart Server官方配置英文文档地址：[https://www.dartlang.org/tutorials/server/get-started][https_www.dartlang.org_tutorials_server_get-started]  
我们也可以使用DartPad体验和运行Dart程序：[https://dartpad.dartlang.org/][https_dartpad.dartlang.org]  
![DartPad界面][DartPad]  
Fast to Study Flutter And Dart. QQ群：979966470

### 1. 下载Dart SDK ###

官方英文文档地址：[https://www.dartlang.org/tools/sdk\#install][https_www.dartlang.org_tools_sdk_install]

本文是在Windows环境下进行安装配置的。  
Windows下需要先安装chocolatey：[https://chocolatey.org/][https_chocolatey.org]  
使用CMD命令安装：

@"%SystemRoot%\System32\WindowsPowerShell\v1.0\powershell.exe" -NoProfile -InputFormat None -ExecutionPolicy Bypass -Command "iex ((New-Object System.Net.WebClient).DownloadString('https://chocolatey.org/install.ps1'))" && SET "PATH=%PATH%;%ALLUSERSPROFILE%\chocolatey\bin"

新建一个chocolatey.bat文件，将上面的这段命令复制进去保存。双击运行这个bat文件就会自动执行安装chocolatey包管理器操作了。  
安装好之后，Windows命令窗口执行如下命令进行dart-sdk稳定版安装：

C:\> choco install dart-sdk

![Dart-SDK安装][Dart-SDK]  
如果想安装dev版，输入以下命令：

choco install dart-sdk --pre

如果想更新dart-sdk，输入以下命令：

choco upgrade dart-sdk

Linux需要执行以下命令：

> sudo apt-get update
    > sudo apt-get install apt-transport-https
    > sudo sh -c 'curl https://dl-ssl.google.com/linux/linux_signing_key.pub | apt-key add -'
    > sudo sh -c 'curl https://storage.googleapis.com/download.dartlang.org/linux/debian/dart_stable.list > /etc/apt/sources.list.d/dart_stable.list'

> sudo apt-get update
    > sudo apt-get install dart

Mac下需要执行以下命令：

> brew tap dart-lang/dart
     > brew install dart

当然除了用命令安装Dart SDK外，我们也可以安装Windows版本安装包文件，下载地址：[http://www.gekorm.com/dart-windows/][http_www.gekorm.com_dart-windows]  
![Dart Web SDK安装包][Dart Web SDK]

在Dart Web SDK里包含以下工具：  
![Dart Web SDK里包含的工具][Dart Web SDK 1]

其实主要的命令工具就是：webdev，用来构建和部署Dart Web程序；dart2js，将dart文件转为js文件的编译工具；dartdevc，一个模块化的dart转js文件的编译工具。  
![Dart Web SDK里包含的工具][Dart Web SDK 2]

chocolatey执行命令安装完dart-sdk后，将Dart SDK的bin目录加入环境变量：  
![配置Dart环境变量][Dart]

测试我们的Dart SDK环境变量是否配置好，输入如下命令：

dart --version

如能够正确输出版本号，则dart环境变量配置成功。  
![测试Dart环境变量是否配置成功][Dart 1]

### 2. 下载开发工具 ###

官方英文使用文档地址：[https://webdev.dartlang.org/tools/webstorm][https_webdev.dartlang.org_tools_webstorm]

开发工具官方推荐是WebStorm，当然也可以使用Visual Studio Code，也可以使用命令工具创建、运行项目。如果想支持命令行运行项目，这样快速方便些。可以安装webdev和stagehand（这里需要安装执行下面这两个命令）：

> pub global activate webdev
    > pub global activate stagehand

安装命令窗口：  
![安装webdev和stagehand][webdev_stagehand]  
注意：如果你想运行使用Dart2以下的版本，WebStorm版本至少要2018.1.3及以上。当然，现在基本都用Dart2及新版本开发了。

接下来下载安装WebStorm：

WebStorm官方下载地址：[https://www.jetbrains.com/webstorm/][https_www.jetbrains.com_webstorm]  
![WebStorm安装界面][WebStorm]

### 3. 创建Dart Server项目 ###

最简单的Dart应用程序包括如下部分：

一个以.dart后缀结尾的dart源文件；  
一个最顶层的main()方法入口函数。

运行这个dart文件，我们可以使用命令：

dart main.dart

Dart官方 Server项目结构图如下图：  
![Server项目结构图][Server]  
bin目录：主要放置命令行式应用的dart文件，其中的一个dart文件必须有main()入口函数。

lib目录：应用额外使用的代码或者库文件。

pubspec.yaml：应用的配置和描述信息文件，和Flutter的pubspec.yaml功能一致。

命令行应用程序（Command-line apps）：

Dart命令行应用程序从命令行独立运行。 命令行应用程序通常用于为Web应用程序提供服务器端支持，但它们也可以是脚本。  
Dart VM直接运行Dart代码而无需中间编译。  
![命令行应用程序][20190314233451770.png]  
使用WebStorm创建命令行应用程序：  
![WebStorm新建命令行项目][WebStorm 1]  
项目结构目录如下图：  
![项目结构目录][watermark_type_ZmFuZ3poZW5naGVpdGk_shadow_10_text_aHR0cHM6Ly9mYW50YXN5LmJsb2cuY3Nkbi5uZXQ_size_16_color_FFFFFF_t_70]  
.dart\_tool目录：主要是pub使用的相关支持文件、Dart工具相关，我们可以不管它。

bin目录：应用程序入口，一般叫main.dart文件，里面有main()入口函数。

pubspec.lock：生成的文件，指定应用程序所依赖的软件包的版本号。

lib目录：存放命令行程序的其他类、源文件，具体业务逻辑dart文件写在这里。

.packages文件：告诉Dart工具在哪里获取应用程序使用的包。该文件由pub get命令创建。你可以忽略这一点。

运行命令行应用程序：  
![运行项目][watermark_type_ZmFuZ3poZW5naGVpdGk_shadow_10_text_aHR0cHM6Ly9mYW50YXN5LmJsb2cuY3Nkbi5uZXQ_size_16_color_FFFFFF_t_70 1]  
当然我们也可以使用命令运行：

pub run bin/main.dart

运行效果图片：  
![运行项目][watermark_type_ZmFuZ3poZW5naGVpdGk_shadow_10_text_aHR0cHM6Ly9mYW50YXN5LmJsb2cuY3Nkbi5uZXQ_size_16_color_FFFFFF_t_70 2]

关于main()入口函数和其他顶层入口函数：  
Dart允许您定义顶级函数，即未封装在类或对象中的函数。 所有应用程序至少有一个顶级函数，即main（）函数。  
函数声明包含两部分：签名和正文（a signature and a body）。  
![函数组成][20190314233846376.png]  
签名设置函数名称，返回值的数据类型以及输入参数的数量和类型。  
![函数组成][20190314233902261.png]  
方法逻辑代码写在花括号（\{…\}）之间。如果正文是单个表达式，那么可以跳过大括号并使用=>简写：

double milesToKM(double miles) => miles / 0.62;

关于文件命名：一般都是小写，单词间用下划线(\_)分隔。

以上是简单的命令行应用程序（Command-line apps）创建过程。

官方详细的命令行应用程序（Command-line apps）编写英文文档地址：[https://www.dartlang.org/tutorials/server/cmdline][https_www.dartlang.org_tutorials_server_cmdline] ，后续将给大家详细讲解。

示例代码：

main.dart

import 'package:untitled2/untitled2.dart' as untitled2;
    
    main(List<String> arguments) {
      print('Hello world: ${untitled2.calculate()}!');
    }

untitled2.dart

int calculate() {
      return 6 * 7;
    }

接下来看下Http Server后端应用（HTTP Clients & Servers）的创建方法：

使用WebStorm创建：

新建项目：  
![WebStorm新建项目][WebStorm 2]  
选择Dart项目，点击CREATE：  
![WebStorm新建项目][WebStorm 3]  
或者创建Dart Web项目，再新建个bin目录也可以。  
![WebStorm新建项目][WebStorm 4]  
项目结构目录如下图：  
![项目结构目录][watermark_type_ZmFuZ3poZW5naGVpdGk_shadow_10_text_aHR0cHM6Ly9mYW50YXN5LmJsb2cuY3Nkbi5uZXQ_size_16_color_FFFFFF_t_70 3]  
运行项目：  
![运行项目][watermark_type_ZmFuZ3poZW5naGVpdGk_shadow_10_text_aHR0cHM6Ly9mYW50YXN5LmJsb2cuY3Nkbi5uZXQ_size_16_color_FFFFFF_t_70 4]  
运行后，可以看到控制台显示的日志，如果看到类似的Dart Server启动成功就可以访问我们的页面了：  
![运行项目][watermark_type_ZmFuZ3poZW5naGVpdGk_shadow_10_text_aHR0cHM6Ly9mYW50YXN5LmJsb2cuY3Nkbi5uZXQ_size_16_color_FFFFFF_t_70 5]  
页面效果截图：  
![运行效果][watermark_type_ZmFuZ3poZW5naGVpdGk_shadow_10_text_aHR0cHM6Ly9mYW50YXN5LmJsb2cuY3Nkbi5uZXQ_size_16_color_FFFFFF_t_70 6]  
页面信息监控：[http://127.0.0.1:54212/\#/vm][http_127.0.0.1_54212_vm]  
![页面信息监控][watermark_type_ZmFuZ3poZW5naGVpdGk_shadow_10_text_aHR0cHM6Ly9mYW50YXN5LmJsb2cuY3Nkbi5uZXQ_size_16_color_FFFFFF_t_70 7]  
官方详细的Http Server后端应用（HTTP Clients & Servers）编写英文文档地址：[https://www.dartlang.org/tutorials/server/httpserver][https_www.dartlang.org_tutorials_server_httpserver] ，后续将给大家详细讲解。

示例代码：

import 'dart:io';
    
    import 'package:args/args.dart';
    import 'package:shelf/shelf.dart' as shelf;
    import 'package:shelf/shelf_io.dart' as io;
    
    main(List<String> args) async {
      var parser = ArgParser()..addOption('port', abbr: 'p', defaultsTo: '8080');
    
      var result = parser.parse(args);
    
      var port = int.tryParse(result['port']);
    
      if (port == null) {
        stdout.writeln(
            'Could not parse port value "${result['port']}" into a number.');
        // 64: command line usage error
        exitCode = 64;
        return;
      }
    
      var handler = const shelf.Pipeline()
          .addMiddleware(shelf.logRequests())
          .addHandler(_echoRequest);
    
      var server = await io.serve(handler, 'localhost', port);
      print('Serving at http://${server.address.host}:${server.port}');
    }
    
    shelf.Response _echoRequest(shelf.Request request) =>
        shelf.Response.ok('Request for "${request.url}"');

![在这里插入图片描述][watermark_type_ZmFuZ3poZW5naGVpdGk_shadow_10_text_aHR0cHM6Ly9mYW50YXN5LmJsb2cuY3Nkbi5uZXQ_size_16_color_FFFFFF_t_70 8]

[https_www.dartlang.org_tutorials_server_get-started]: https://www.dartlang.org/tutorials/server/get-started
[https_dartpad.dartlang.org]: https://dartpad.dartlang.org/
[DartPad]: /images/20220308/7d0ad39886424faebd7c022dca91fc5d.png
[https_www.dartlang.org_tools_sdk_install]: https://www.dartlang.org/tools/sdk#install
[https_chocolatey.org]: https://chocolatey.org/
[Dart-SDK]: /images/20220308/19212b6acfe643149164af2b3b4db63f.png
[http_www.gekorm.com_dart-windows]: http://www.gekorm.com/dart-windows/
[Dart Web SDK]: /images/20220308/ddd0d92eb4ae4deabf6d90159a58749b.png
[Dart Web SDK 1]: /images/20220308/8a7baa2ccf774e5e83bcd5cd4b1a5861.png
[Dart Web SDK 2]: /images/20220308/fffea9fadf7b44f6bbb3c7c31125ff36.png
[Dart]: /images/20220308/252f9c9e5b554dbf8620cf54ae5f3cf1.png
[Dart 1]: /images/20220308/7d28cc8faa1e4cb99ec9077351095ed9.png
[https_webdev.dartlang.org_tools_webstorm]: https://webdev.dartlang.org/tools/webstorm
[webdev_stagehand]: /images/20220308/c23acae7911e4433be410deae7b5779a.png
[https_www.jetbrains.com_webstorm]: https://www.jetbrains.com/webstorm/
[WebStorm]: /images/20220308/8377e6689c954c6e855846e017d8e0d5.png
[Server]: /images/20220308/bb3acfaec0744ad6818facfb94ee83f9.png
[20190314233451770.png]: /images/20220308/963016d7ac8b4946b26b4947020bf43c.png
[WebStorm 1]: /images/20220308/bb919997cdde43a5b1fec54edf4183c0.png
[watermark_type_ZmFuZ3poZW5naGVpdGk_shadow_10_text_aHR0cHM6Ly9mYW50YXN5LmJsb2cuY3Nkbi5uZXQ_size_16_color_FFFFFF_t_70]: /images/20220308/5776b4d2869d4bc9b522b90a1e9668d0.png
[watermark_type_ZmFuZ3poZW5naGVpdGk_shadow_10_text_aHR0cHM6Ly9mYW50YXN5LmJsb2cuY3Nkbi5uZXQ_size_16_color_FFFFFF_t_70 1]: /images/20220308/b0e941bcf86d48fbb4ca3833b74a3b9d.png
[watermark_type_ZmFuZ3poZW5naGVpdGk_shadow_10_text_aHR0cHM6Ly9mYW50YXN5LmJsb2cuY3Nkbi5uZXQ_size_16_color_FFFFFF_t_70 2]: /images/20220308/ab8be4f4d3c442e088c3aaf701f3c748.png
[20190314233846376.png]: /images/20220308/1538b673350e4168873ce0736f8d8964.png
[20190314233902261.png]: /images/20220308/4974a3c581a541599054a14942862a8b.png
[https_www.dartlang.org_tutorials_server_cmdline]: https://www.dartlang.org/tutorials/server/cmdline
[WebStorm 2]: /images/20220308/e2b9a85ce64d42c2a654cae3bd201427.png
[WebStorm 3]: /images/20220308/868359d5dfc746af99ded6ad7c5d9023.png
[WebStorm 4]: /images/20220308/44f45295d5b9442081bb04b530f970b1.png
[watermark_type_ZmFuZ3poZW5naGVpdGk_shadow_10_text_aHR0cHM6Ly9mYW50YXN5LmJsb2cuY3Nkbi5uZXQ_size_16_color_FFFFFF_t_70 3]: /images/20220308/40f7a1f92aa54a5aba924e1fad2b4082.png
[watermark_type_ZmFuZ3poZW5naGVpdGk_shadow_10_text_aHR0cHM6Ly9mYW50YXN5LmJsb2cuY3Nkbi5uZXQ_size_16_color_FFFFFF_t_70 4]: /images/20220308/504ec6235aaa483a84f36e3afcf346c8.png
[watermark_type_ZmFuZ3poZW5naGVpdGk_shadow_10_text_aHR0cHM6Ly9mYW50YXN5LmJsb2cuY3Nkbi5uZXQ_size_16_color_FFFFFF_t_70 5]: /images/20220308/62f6065132bd4e8aa9fb3f767290a15b.png
[watermark_type_ZmFuZ3poZW5naGVpdGk_shadow_10_text_aHR0cHM6Ly9mYW50YXN5LmJsb2cuY3Nkbi5uZXQ_size_16_color_FFFFFF_t_70 6]: /images/20220308/473f3fa5e9a846358f7743dd9d64f9fa.png
[http_127.0.0.1_54212_vm]: http://127.0.0.1:54212/#/vm
[watermark_type_ZmFuZ3poZW5naGVpdGk_shadow_10_text_aHR0cHM6Ly9mYW50YXN5LmJsb2cuY3Nkbi5uZXQ_size_16_color_FFFFFF_t_70 7]: /images/20220308/bc1428fa37714a769c972f412f0d1ff6.png
[https_www.dartlang.org_tutorials_server_httpserver]: https://www.dartlang.org/tutorials/server/httpserver
[watermark_type_ZmFuZ3poZW5naGVpdGk_shadow_10_text_aHR0cHM6Ly9mYW50YXN5LmJsb2cuY3Nkbi5uZXQ_size_16_color_FFFFFF_t_70 8]: /images/20220308/5a680b0917ad4c52b853393559107f20.png