言語、フレームワークなど | バージョン |
---|---|
Swift | 5.0 |
Yarn | 5.0 |
ツール名 | 目安となるバージョン |
---|---|
Xcode | 12.5.1 |
xcpretty | 0.3.0 |
Node.js | 14., 16. |
Yarn | 1.* |
バージョンが異なる場合、動作しない場合があります。
Stationのクリア判定にxcprettyというライブラリを使用します。
以下のコマンドでxcpretty
をインストールしてください。
$ gem install xcpretty
gem
コマンドの実行でエラーが出る場合は、HomebrewやRubyの設定を確認し、修正してください。
次の手順で取り組み始めてください。
画面右上にあるForkより iOS Railwayのリポジトリを自分のアカウントにForkしてください。
作成したリポジトリを作業するディレクトリにクローンしましょう。
- Terminal.app(iTerm2などでも良い)
で作業するディレクトリを開き、次のコマンドでForkしたiOS Railwayのリポジトリをローカルにクローンしてください。
git clone https://github.com/[GitHubのユーザー名]/ios-stations.git
SSHでクローンを行う場合には、次のようになります
git clone [email protected]:[GitHubのユーザー名]/ios-stations.git
GitHubのIDがSuguruOokiだとしたら、例としては次のようになります。
[email protected]:SuguruOoki/ios-stations.git
Terminal.app を開き、次のコマンドをコピーアンドペーストで実行してください。
/usr/bin/ruby -e "$(curl -fsSL https://raw.githubusercontent.com/Homebrew/install/master/install)
すでにインストール済みの方は、この手順を飛ばしてください。 インストールされたかどうかを確認するには、Terminal.app を開いて
brew -v
を実行してください。インストール済みであれば次のような表示になるはずです。
何か起こった際には次の公式サイトを確認してください。
Homebrew を使って、 Node.js をインストールします。 Terminal.app を開き、次のコマンドをコピーアンドペーストで実行してください。
brew install node
インストールされたかどうかを確認するには、Terminal.app を開いて
node -v
を実行してください。インストール済みであれば次のような表示になるはずです。
v から先は、インストールしたバージョンが表示されるため、上記画像の表示と全く同じバージョンでなくても大丈夫です。
本当は Node.js のバージョン管理ツールである n
や nodebrew
などのツールを入れた方が実践的ですが、パスの修正などができないとトラブルが起きた時に何もわからなくなるので、わからないうちはお勧めしません。
一旦素直に Homebrew で直接 Node.js の最新版をインストールしておきましょう。
Terminal.app を開き、次のコマンドをコピーアンドペーストで実行してください。
brew install yarn
インストールされたかどうかを確認するには、Terminal.app を開いて
yarn -v
を実行してください。インストール済みであれば次のような表示になるはずです。
yarn install
こちらでTechTrainのログインを求められますので、メールアドレスとパスワードを入れてログインしましょう。 GitHubでサインアップした方は、こちらからパスワードの再発行より、パスワードを発行して、そのパスワードでログインしてください。
Station の問題は、TechTrain の画面で確認してください。
Forkしたリポジトリは、Fork元のリポジトリの状態を自動的に反映してくれません。 Stationの問題やエラーの修正などがなされておらず、自分で更新をする必要があります。 何かエラーが出た、または運営から親リポジトリを更新してくださいと伝えられた際には、こちらを試してみてください。
# こちらは、自分でクローンした[GitHubユーザー名]/ios-stationsの作業ディレクトリを前提としてコマンドを用意しています。
# 自分が何か変更した内容があれば、 stash した後に実行してください。
git remote add upstream [email protected]:TechBowl-japan/ios-stations.git
git fetch upstream
これらのコマンドを実行後にうまくいっていれば、次のような表示が含まれています。
git branch -a ←このコマンドを実行
* master
remotes/origin/HEAD -> origin/main
remotes/origin/main
remotes/upstream/main ←こちらのような upstream という文字が含まれた表示の行があれば成功です。
こちらで自分のリポジトリを TechBowl-japan/ios-stations の最新の状態と合わせるための準備は終了です。
# 自分の変更の状態を stash した上で次のコマンドを実行してください。
# ↓main ブランチに移動するコマンド
git checkout main
# ↓ TechBowl-japan/ios-stations の最新の状態をオンラインから取得
git fetch upstream
# ↓ 最新の状態を自分のリポジトリに入れてローカルの状態も最新へ
git merge upstream/main
git push
クリア判定のテスト実行については、PCの性能にもよりますが通常1分以内に終わります。
もし数分以上待ってもテストの実行が終わらない場合は、なんらかのキャッシュやプロセスが影響している可能性があるため、PCを再起動するといった対応を行ってください。