はじめに
言語を試す #
Wrenを試すには、いくつかの方法があります。
- ブラウザーで。 ここでWrenを試せます!
- 自分のコンピューターで。 Wren CLIプロジェクトはダウンロードできる実行ファイルで、ファイル入出力などを利用するスクリプトを実行できます。Wren CLIの文書を参照してください。
- 自分のコードに組み込んで。 下のWrenのビルドと組み込みを参照してください。
続いて、組み込みガイドを読んでください!
試せる場所が用意できたら、言語を学ぶ番です。
VMを組み込む #
Wren仮想マシンは、Wrenのソースコードを実行する言語の中核です。単なるライブラリであり、単独で動くアプリケーションではありません。より大きなホストアプリケーションに組み込むことを意図しています。
C標準ライブラリ以外に依存するものはありません。静的ライブラリや共有ライブラリとして利用しても、ソースをアプリケーションに含めてコンパイルしてもかまいません。
Wrenをビルドする #
Wrenライブラリをビルドするには、projects/フォルダーを見ます。ここにはVisual Studio、XCode、およびmakeなどのツール向けに、すぐ使えるプロジェクトが入っています。
- Windows
projects/vs2019/(またはvs2017)内のwren.slnを開き、ビルドを実行します。 - Mac
projects/xcode/内のwren.xcworkspaceを開き、ビルドを実行します。 - Linux
projects/make/内でmakeを実行します。
いずれの場合も、ルートのlib/フォルダーにライブラリのファイルが生成されます。
必要に応じて、これらを自分のプロジェクトにリンクします。
- 静的リンク Windowsでは
wren.lib、それ以外ではlibwren.aです。 - 動的リンク Windowsでは
wren.dll、Linuxではlibwren.so、Macではlibwren.dylibです。
既定のビルドでは、bin/内にwren_testも生成されます。
これは言語のテストを実行するためのバイナリーで、簡単なスクリプトも実行できます。
その他のプラットフォーム
利用するプラットフォームが明示的にサポートされていない場合は、移植性を得るため、自分のプロジェクトにWrenのソースを含めることをお勧めします。
自分のプロジェクトにコードを含める #
すべてのソースファイル
用意されているプロジェクトでビルドする代わりに、自分のプロジェクトへWrenのソースコードを含めることもできます。依存関係がないので、src/にあるコードをすべて含めるだけです。詳しくはsrc/内のreadmeを参照してください。
「amalgamated」ビルド
さらに簡単な方法として、「amalgamated」ビルド(blobまたはunityビルドとも呼ばれます)があります。これはWrenのすべてのソースコードを一つのファイルにまとめたものです。
このファイルはpython3 util/generate_amalgamation.py > build/wren.cを実行すると生成され、出力はbuild/wren.cに保存されます。
自分のプロジェクトのコードにbuild/wren.cとsrc/include/wren.hを含めれば、準備は完了です。将来的には、この生成を自動化してリポジトリに含められるとよいと考えています。
バグを見つけた場合や、アイデア・質問がある場合は、次のいずれかを利用してください。
- Discordコミュニティーに参加する。
- Wrenのメーリングリストで質問する(あまり活発ではありません)。
- Twitterの@munificentbobまたは@ruby0x1に知らせる。
- GitHubリポジトリにチケットを登録する。
- CLIにもチケットとGitHubリポジトリがあります。
- プルリクエストを歓迎します。