一、 Package 關鍵字

import、as、show 、hide、part、part of、export、library、deferred as。

二、關鍵字探究

• import

  import 對于 iOS 開發(fā)者并不陌生，它是在 OC 頭文件導入時使用的關鍵字。在 Flutter 中 import 的作用也是導入，導入Package的關鍵字。在 Flutter 中的形式:
  import 'package:xxxx.dart'; 和 import 'xxxx.dart';

  實例如下:

  import 'package:flutter/material.dart';
  import 'sign_record.dart';
  
  class TestApp extends StatelessWidget {
    @override
    Widget build(BuildContext context) {
      return Container(
        child: SignRecordRouter(),
      );
    }
  }
  

  上面是導入 material和sign_record文件引用提供下邊使用。

  注意

  1. 兩種導入形式的區(qū)別
     import 'package:xxxx.dart';是相對地址導入
     import 'xxxx.dart';是絕對地址導入
  2. 兩種導入形式優(yōu)劣
     import 'package:xxxx.dart'; 的優(yōu)點是項目中使用導入文件的文件位置發(fā)生變化，不影響文件的頭文件導入路徑。
     import 'xxxx.dart'; 的缺點是項目中使用導入文件的文件的位置發(fā)生變化，影響文件的頭文件導入，需要變更導入文件的路徑。

• as

  Flutter 導入文件時的 as 的作用是給導入的 Package 進行命名。在使用時使用新命名的名進行調(diào)用屬性、方法等。
  常用于:1. 簡化Package的名字使用 2. 解決導入 Package 中類、屬性、方法發(fā)生沖突時，使用 as 進行區(qū)分調(diào)用。

  實例代碼:

  import 'package:testapp/A1/dog.dart';
  import 'package:testapp/B1/aa.dart';
  
  void main() {
    var dog = Dog();
    print(dog);
  }
  

  上面代碼其中 aa.dart 和dog.dart 文件內(nèi)容相同都是一個Dog 類，代碼如下:

  class Dog {
  String name;
    void run() {
      print(name + "奔跑");
    }
  }
  

  所以在導入dog 和 aa 文件下，使用 Dog 類，就會報錯，錯誤信息是:

  [class Dog, class Dog]
  'Dog' isn't a function.
  Try correcting the name to match an existing function, or define a method or function named 'Dog'.dartinvocation_of_non_function
  The name 'Dog' is defined in the libraries 'package:testapp/A1/dog.dart' and 'package:testapp/B1/aa.dart'.
  Try using 'as prefix' for one of the import directives, or hiding the name from all but one of the imports.
  

  解決方法如下:

  import 'package:testapp/A1/dog.dart' as ADog;
  import 'package:testapp/B1/aa.dart' as BDog;
  
  void main() {
    var dog = ADog.Dog();
    dog.name = "A";
    dog.run(); // A奔跑
  
    var dog1 = BDog.Dog();
    dog1.name = "B";
    dog1.run(); // B奔跑
  }
  

  注意

  在調(diào)用Package引入文件的方法、屬性、類時，如果調(diào)用文件下有相同的屬性、方法、類時，如果引入文件不做 as 從新命名調(diào)用，則會被本地方法、屬性、類所替換。實例如下:

  // dog.dart
  void getInfo() {
    print("A 獲取信息");
  }
  
  // aa.dart
  void getInfo() {
    print("B 獲取信息");
  }
  
  // 使用
  import 'package:testapp/A1/dog.dart' as ADog;
  import 'package:testapp/B1/aa.dart';
  
  void main() {
    ADog.getInfo();
    getInfo();
  }
  
  void getInfo() {
    print("本地方法");
  }
  

  上面輸出: A 獲取信息和本地方法 而不是A 獲取信息和B 獲取信息, 因為 aa 中的 getInfo 方法被本地替換，而使用命名調(diào)用的則不會替換。

• show 和 hide

  show 和 hide 是對引入庫里面的內(nèi)容進行選擇性添加或者去除使用。首先我們給dog.dart添加類，代碼如下:

  class Dog {
    String name;
    void run() {
        print(name + "奔跑1");
    }
  }
  
  class BigDog {
    String name;
    void run() {
        print(name + "奔跑2");
    }
  }
  
  class MiddleDog {
    String name;
    void run() {
        print(name + "奔跑3");
    }
  }
  
  class SmallDog {
    String name;
    void run() {
        print(name + "奔跑4");
    }
  }
  
  

  • show
    show 是對引入庫內(nèi)容進行選擇性使用，多個選擇使用逗號分隔。實例如下:

    import 'package:testapp/A1/dog.dart' show Dog, MiddleDog;
    
    void main() {
      var dog = Dog();
      print(dog);
      var middleDog = MiddleDog();
      print(middleDog);
    }
    

    上面我們使用 show 選擇性的使用Dog 和 MiddleDog 兩個類，dog.dart 中的其他類不能被調(diào)用。

  • hide

    hide 是對引入庫內(nèi)容進行選擇性的剔除使用，多個選擇使用逗號分隔。實例如下:

    import 'package:testapp/A1/dog.dart' hide Dog, MiddleDog;
    
    void main() {
      var dog = SmallDog();
      print(dog);
      var dog1 = BigDog();
      print(dog1);
    }
    

    上面我們使用 hide 選擇性剔除Dog 和 MiddleDog 兩個類，dog.dart 中的其他類能被調(diào)用。

• part 和 part of

  part 和 part of 在 Flutter 的 Package 開發(fā)中配套使用。part 是用于 Package 內(nèi)模塊文件路徑引用的關鍵字; 而 part of 是用于 Package 內(nèi)模塊指定屬于哪個Package。使用實例代碼如下:

  /// part
  library idkit_toast;
  
  import 'package:flutter/material.dart';
  part 'src/toast_api.dart';
  part 'src/toast_style.dart';
  /// part of
  part of idkit_toast;
  class IDKitToast {
    Widget getChild() {
        return Containter();
    }
  }
  

  上面使用 part 引出 IDKitToast 類所在文件路徑，在IDKitToast文件中使用part of 指定該類屬于idkit_toast,同時，在IDKitToast 用到的其他類等的引用則將在part 所在文件內(nèi)添加。

• export

  export 將一個文件中使用頭文件進行整合到一個文件中，在文件在導入整合文件就可以使用全部整合文件中所有模塊。在不使用 export 整合的代碼如下:

  import 'package:testapp/A1/cat.dart';
  import 'package:testapp/A1/dog.dart';
  import 'package:testapp/A1/pig.dart';
  
  void main() {
    var dog = Dog();
    print(dog);
    var cat = Cat();
    print(cat);
    var pig = Pig();
    print(pig);
  }
  

  使用exprot 將 cat.dart 、dog.dart、pig.dart 整合到a1.dart 文件中，代碼如下:

  export 'cat.dart';
  export 'dog.dart';
  export 'pig.dart';
  

  使用 a1.dart 文件修改不使用export的代碼修改:

  import 'package:testapp/A1/a1.dart';
  
  void main() {
    var dog = Dog();
    print(dog);
    var cat = Cat();
    print(cat);
    var pig = Pig();
    print(pig);
  }
  

  注意

  exprot 也有show 和 hide ,代碼如下:

  // a1.dart
  export 'cat.dart';
  export 'dog.dart' show MiddleDog;
  export 'pig.dart';
  
  // main.dart
  import 'package:testapp/A1/a1.dart';
  
  void main() {
    var dog = MiddleDog();
    print(dog);
    var cat = Cat();
    print(cat);
    var pig = Pig();
    print(pig);
  }
  

  注意: export重新導入的庫相當于將庫內(nèi)代碼復制到當前文件中，但在當前文件并不能使用。

• library

  library 將當前文件聲明為一個庫，形式:library xx。實例代碼:

  library idkit;
  
  part 'pig.dart';
  
  class IDKit {
    void init() {
      var pig = Pig();
      print(pig);
    }
  }
  

• deferred as

  deferred as 是在應用在需要加載庫時進行延遲加載，常用于減少 App 的啟動時間。實例代碼:

  import 'package:testapp/A1/library.dart' deferred as Id;
  
  void main() {
    getLibrary();
    getLibrary();
    print("啟動完成");
  }
  
  Future getLibrary() async {
    await Id.loadLibrary();
    var id = Id.IDKit();
    id.init();
  }
  

  盡管你可能在項目中多次調(diào)用 loadLibrary()來加載一個庫，但是這個庫也只會被加載一次。