Difference between revisions of "Get source and compile/ja"

Latest revision as of 13:47, 17 November 2022

この情報は、ビューアのソースコードを使って何かしたい人に向けて書かれたものです。

Snowstorm プロジェクト

こちらにあるのが、最新のビューアのソースコードとなります。ビューアのソースコードは、オープンソースのリポジトリサイト、GitHub の Gitリポジトリにあります。そこにはたくさんのバージョンがありますが、多くの人が関心があるのは、おそらく以下のバージョンでしょう。

Second Life Viewer

普通の Web ブラウザでソースコードをブラウズすることもできますし、パソコンにダウンロードすることもできますし、Mercurial を使って好きなように操作することもできます。

Viewer-Development ブランチの面白い特徴の一つに、Linden の担当者がバグフィックスや新しい機能を目の前で追加していくのを文字通り観察できる、というのがあります。

それ以外にソースコードをブラウズするやり方として、Doxygen を使う方法があります。この方法では、UML ダイアグラムも参照することができます。

必ず Creating a version control repository をご一読ください。

バージョン管理

ビューアの開発には Gitバージョン管理システムを利用しています。現在のリリースのリポジトリをクローンするには、以下のコマンドを使ってください。

git clone https://github.com/secondlife/viewer.git

コンパイル

プラットフォームごとのコンパイル手順が、以下のページに記載されています。

補足

Common compilation problems ビルドでエラーが発生した場合はこちら
Improving compilation time もっと高速にコンンパイルする方法
LLMozLib2 LLMozLib2 のビルド

Autobuild

Autobuild は、ビューアからサードパーティーのライブラリまで、あらゆるものを管理／ビルドする Linden Lab の新しいフレームワークです。

手順の説明:

実行する際のヒント

チャネルとバージョンについて

チャネルというものは、単にバージョンをグループ化したものです。Linden Lab ではチャネルを使い、 Project、Beta、Release Vewers のそれぞれに対してアップデートの追跡／提供を行っています。

自分でコンパイルしたビューアを起動したときに強制アップデートを伝えるメッセージが出ても、あわてる必要はありません。自分が作ったものは全く消えません。(通常は)新しいソースリリースに対して変更を適用しなくても、自分のソースコードをテストできます。ここで、チャネルの出番です。

ログインするときに、チャネル名とバージョンの組み合わせが、リストと照合されます。チャネルごとに、特定のバージョンのログインが許可されたり、ブロックされたりします。ブロックされるビューアは、危険なビューア (セキュリティ問題があるもの)、非互換なビューア (プロトコルが著しく変更されたもの)、サポートが打ち切られたビューア (古すぎてサポートの提供が割に合わないとリンデン社が判断したもの)、(ここで最も関係あるものとして)テストチャネルにあるビューア(Release Candidate, First Look) です。Linden Lab は、最新バージョンのビューアで生成されるデータだけをテストしたいと考えています。

Setting a Channel and Version for an Open Source Viewer に、ソースコードでこれを行う方法が説明されています。

Channel and Version Requirements に、Linden Lab が Second Life でチャネルとバージョンを扱う際の公式なポリシーが詳細に説明されています。

The Third Party Viewer Policy で、全てのビューアには一意のチャネル名を付けなければならない旨が規定されています。詳細はこちらを参照してください。

@@ Line 7: / Line 7: @@
 こちらにあるのが、最新のビューアのソースコードとなります。
-ビューアのソースコードは、オープンソースのリポジトリサイト、[https://bitbucket.org/lindenlab bitbucket] の Mercurial (hg) リポジトリにあります。そこにはたくさんのバージョンがありますが、多くの人が関心があるのは、おそらく以下のバージョンでしょう。
+ビューアのソースコードは、オープンソースのリポジトリサイト、[https://github.com/secondlife GitHub] の [https://en.wikipedia.org/wiki/Git Git]リポジトリにあります。そこにはたくさんのバージョンがありますが、多くの人が関心があるのは、おそらく以下のバージョンでしょう。
-* [https://bitbucket.org/lindenlab/viewer-release Viewer Release]
+* [https://github.com/secondlife/viewer Second Life Viewer]
-* [https://bitbucket.org/lindenlab/viewer-beta Viewer Beta]
-* [https://bitbucket.org/lindenlab/viewer-development The latest developer test builds]
 普通の Web ブラウザでソースコードをブラウズすることもできますし、パソコンにダウンロードすることもできますし、Mercurial を使って好きなように操作することもできます。
@@ Line 23: / Line 21: @@
 === バージョン管理 ===
-ビューアの開発には Mercurial (hg) 分散バージョン管理システムを利用しています。現在のリリースのリポジトリをクローンするには、以下のコマンドを使ってください。
+ビューアの開発には Gitバージョン管理システムを利用しています。現在のリリースのリポジトリをクローンするには、以下のコマンドを使ってください。
-  <nowiki>hg clone http://hg.secondlife.com/viewer-release</nowiki>
+  <nowiki>git clone https://github.com/secondlife/viewer.git</nowiki>
-[[Mercurial Tools|Linden Lab Mercurial Tools]] もインストールすることを強くお奨めします。
-(上記の手順で取得した)最初のクローンに自分の変更を加えるという、ソース管理のワークフローの概要を逐一説明したものは、[[Develop Viewer Code#Steps To Submit a Change|Steps To Submit a Change]] にあります。
 == コンパイル ==
@@ Line 48: / Line 42: @@
 手順の説明:
-* [[Build Viewer With Autobuild]]
+* [[Building the Viewer with Autobuild/ja]]
 * [[Build_3rd_Party_lib_with_Autobuild]]