🐷 🔶 🧑🏿‍🤝‍🧑🏽 sbtの概要 👩🏽‍🍳 👨‍👨‍👧‍👦 🧔🏽

この投稿では、Scala言語の現在の成長に伴い、ますます一般的になっているツールに関する公式ドキュメントの一連の翻訳を開始しようとしますが、ロシア語にはほとんど情報がありません。

Scala言語のプロジェクトアセンブリシステムであるsbtについて説明します（ただし、Javaプロジェクト（および一般に他のプロジェクト）も作成できることに注意することが重要です）。

この記事はscala-sbt.orgプロジェクトのWebサイトからのドキュメントの翻訳の始まりであり、これが私の最初の翻訳経験であるため、コメントや修正を歓迎します。

また、翻訳は記事の形式ですが、マニュアルの別の部分の文脈ではあまり正しくない点はスキップします。

まえがき

sbtは、少数の概念を使用して、プロジェクトを構築するための柔軟なソリューションを提供します。

このチュートリアルでは、sbtを使用したビルドソリューションの作成とサポートに必要なものをいくつか取り上げます。

このマニュアルを読むことを強くお勧めします。ただし、すべてを読む時間がない場合は、「アセンブリ.sbtパラメータ」、「アセンブリ領域」、「追加アセンブリパラメータ」のセクションで最も重要な情報を読むことができます。しかし、この良いアイデアがこのガイドのすべてのページをスキップするのに役立つとは約束しません。

以前の資料を参考にして、このドキュメントを順番に読んでください。

sbtをご利用いただきありがとうございます！どうぞよろしくお願いします！

1. sbtをインストールする

sbtプロジェクトを作成するには、次の手順を実行する必要があります。

sbtをインストールし、起動スクリプトを作成します
シンプルな「Hello world」プロジェクトを作成する
内部にソースファイルを含むプロジェクトディレクトリを作成する
ビルドオプションの説明
sbtの実行方法を読む
sbtビルドオプションのマニュアルを読み続けます

最終的に、インストールは最終的にJARファイルとシェルスクリプトの実行になります。ただし、インストールの面倒さを軽減できるさまざまなプラットフォームのいくつかのパスについて説明します。

sbtの起動に問題がある場合は、「インストールに関する注意」セクションを参照してください。

1.a. Macインストール

Macportsを使用する

$ port install sbt

自作

$ brew install sbt

1.b. Windowsインストール

msiインストーラーをダウンロードして実行するだけです。

1.c. Linuxインストール

公式にサポートされているディストリビューション：

RPMパッケージ

DEBパッケージ

将来、sbtを手動でダウンロードして構成する方法についてお話します。 それまでの間、最も興味深い。

2.こんにちは、World

ソースコードでプロジェクトディレクトリを作成する

sbtプロジェクトの正しいオプションの1つは、1つのソースファイルを含むディレクトリです。 hw.scalaファイルを使用して、次の内容のhelloディレクトリを作成してみてください。

 object Hi { def main(args: Array[String]) = println("Hi!") }

次に、ディレクトリ自体で、sbtを実行し、対話型コンソールでrunコマンドを入力します。 LinuxまたはOS Xでは、次のようになります。

 $ mkdir hello $ cd hello $ echo 'object Hi { def main(args: Array[String]) = println("Hi!") }' > hw.scala $ sbt ... > run ... Hi!

プロジェクトを作成するとき、sbtは次の規則に従って機能します。

ソースはルートディレクトリにあります
ソースはsrc / main / scalaまたはsrc / main / javaディレクトリにあります
テストはsrc / test / scalaまたはsrc / test / javaにあります
src / main / resourcesまたはsrc / test / resourcesのリソースファイル
libディレクトリのjarファイル

デフォルトでは、sbtはそのバージョンのscalaでプロジェクトをビルドし、sbtはそれ自体で起動されます。

コンソールの起動に加えて、 sbt runコマンドでプロジェクトをすぐに起動して実行できます。

ビルドオプション

ほとんどのプロジェクトでは、さらに洗練されたビルドプロセスのセットアップが必要です。 sbtでは、メインアセンブリパラメーターはプロジェクトのルートディレクトリにあるbuild.sbtファイルに保存されます。

たとえば、helloプロジェクトの設定ファイルを作成した場合、次のようになります。

 name := "hello" version := "1.0" scalaVersion := "2.10.3"

空の行に注意してください。それだけではなく、実際には設定ファイル内の行を区切る必要があり、それらがないとsbtはエラーを出します。このファイルの詳細については、次のセクションで説明します。

sbtバージョンをインストールする

hello / project / build.propertiesファイルに次の行を書き込むと、必要なバージョンのsbtを強制的にダウンロードしてインストールできます。

sbt.version=0.13.5

これで、起動時にsbtバージョン0.13.5が使用されます。そうでない場合、スクリプトはシステムにダウンロードしてインストールします。

衝突の可能性を避けるために、sbtバージョンをproject / build.propertiesファイルに保存します。

結論として

実験のために、私はこれらの非常に最初のセクションだけに自分自身を制限することにし、反応が多かれ少なかれ肯定的であれば、私は残りを翻訳し続けることを望みます。

PS翻訳の指摘された不正確さとコメントに非常に感謝します。よろしくお願いします！

sbtの概要