gdドキュメント0.8.0

importとパッケージ

English | 日本語

再利用するコードや共通定数は@importで使えます。ローカルファイルは相対パス、インストールしたパッケージはプロジェクトに登録した別名で読み込みます。

preload宣言を繰り返さず設定を共有する

settings.gdを作ります。

const TITLE := "Hello, world!"
const PORT := 8080

app.gdからそのまま使えます。

@import "./settings"

func main():
    print(settings.TITLE)
    print(settings.PORT)
    return 0
gd app.gd

ファイル名からsettingsという名前が付きます。.gdやas settingsは必要ありません。利用側で毎回const Settings = preload(...)を書くことも避けられます。小さな使い捨てスクリプトは1ファイルのままで構いません。共有する設定など、役割が分かれる場合に分割します。

登録所のパッケージを追加する

パッケージ一覧からパッケージを選び、記載された名前と、利用したいバージョンの範囲を指定して追加します。gd.jsonには、使うパッケージと、スクリプトから読み込むための短い別名が登録されます。

gd add hello gd:@scope/hello@^1.0.0

これは構文を示す例なので、実行時は一覧にあるパッケージへ置き換えてください。インストールした別名は引用符なしで読み込みます。

@import hello

@import settingsは登録済みのパッケージ別名を指します。ローカルの@import "./settings"を省略した書き方ではありません。

依存関係を再現する

gd.jsonとgd.lockをコミットします。gd.lockに記録したバージョンを変えずにインストールする場合はgd install --frozenを使います。秘密情報、ローカルの認証情報、一時的なビルドデータはパッケージに含めないでください。パッケージの設定、公開方法、利用するバージョンの決まり方はパッケージの手引きで説明しています。