2024.09.07 2024.09.15

【Mac,Windows】AtCoder用C++コンテナ環境の使い方

海洋

利用環境

MacOS 15.1
Cursor 0.40.4
Docker Desktop 4.34.2

この記事ではVSCodeのDev containersを使用したAtCoder用C++コンテナ環境の使用方法を紹介しています。
準備に関しては別記事で解説しておりますので使いたい方はそちらを先にご覧ください。

導入方法はこちら

【AtCoder,C++,環境構築】手元のPCでプログラムを書こう！

このコンテナ環境はAtCoder CLI（acc）、Online Judge Tools（oj）を使用しているので、問題のダウンロード、テストケースを使用したテスト、提出などの操作がエディタ上で完結できます。これらの操作はタスクを利用することで簡単に実行できるようになっています。

また、公式ライブラリのAtCoder Libraryも利用できます。

【リポジトリ】AtCoder-cpp-env

それでは使用方法を解説していきます。

contents

接続・切断方法

はじめにコンテナの接続・切断方法について解説します。
今開いている画面がコンテナ環境なのかローカル環境なのかの判断ですが、ローカル環境であれば、><のみが表示され、接続されていれば”開発コンテナー：atcoder-cpp@desktop-linux”と表示されます。

以下で接続・切断方法について説明しますが、コンテナ環境接続状態でそのままエディタを閉じても次回エディタ起動時に自動で接続されます。

なので、これが一番楽ですが私は一応切断して閉じるようにしています。お好きな方法でどうぞ。

コンテナの切断

切断は上で説明したエディタ左下のアイコンをクリックして出てくるメニューで行います。

おすすめは”フォルダーをローカルで再度開く”です。するとこのコンテナ環境のフォルダが開かれたままローカル環境に移行します。すると次回接続する際フォルダを選択せず接続できます。

“リモート接続を終了する”を選択しても良いのですが、こちらはコンテナ環境のフォルダ自体も閉じてしまうので、再接続の際にまたフォルダを選択する手間があります。

コンテナへの接続

接続もエディタ左下のアイコンをクリックして出てくるメニューで行います。

“コンテナーで再度開く”を選択することで再度接続することが出来ます。

使用方法（注意）

普段使用するフォルダはそれぞれのコンテストに対応した以下の4つです。

ABC
ARC
AGC
Others

ダウンロードした問題は全てこのフォルダにダウンロードされます。ABC、ARC、AGC以外のコンテストは全てOthersに入ります…。

そしてこれらのフォルダ・ダウンロードされた問題なども含め、全てのフォルダ・ファイル名は変更しないでください。変更したら動かなくなります。
変更可能なのはコンテナ環境をダウンロードしたときの親フォルダだけです。

使用方法（タスク）

ここからはVSCodeのタスク機能を使った使用方法について解説します。

Task Runnerがインストールされていれば、画面左下にタスクが表示されるのでこれをクリックして各機能を実行していきます。テスト、提出は現在エディタで開いているコードに対して実行されます。

問題のダウンロード

まずは問題をダウンロードしましょう。
“c.ダウンロード”を選択するとコンテストIDを聞かれるので、コンテストIDを入力します。

コンテストIDとはAtCoderのコンテストトップページのURLのcontests/以降の部分のことです。

ID入力後決定すると、問題ディレクトリ・テストケースファイルなどのダウンロードとテンプレートファイルが作成され、A問題のcppファイルが開かれます。

もし、すでにダウンロードしてあるコンテストを入力した場合、上書きされることなくそのコンテストの問題Aが開かれます。

他の問題への移動は、サイドバーの各問題ディレクトリの中にあるmain.cppを選択することで行います。

注意点としてAtCoderが用意している入門教材”C++入門 AtCoder Programming Guide for beginners (APG4b)“などは、通常のコンテストと違い問題の順番がアルファベット昇順になっていないため使用はおすすめしません。

そういった場合は適当なコンテストの問題ディレクトリのmain.cppファイルを使用して、シンプルにコード補完やシンタックスハイライトのみを使ってコードを書いていきましょう。もちろんこの方法ではテストも提出も行えません。

また、他にもこのダウンロード機能に向かないコンテストがあるかもしれませんが把握していません。

コードのテスト

コードを書き終えたらテストケースでテストしてみましょう。ちなみにこのテストケースはAtCoderの問題ページの入力例・出力例と同じです。

テストしたいコードをエディタ上で開いた状態で”a.テスト”を選択します。
すると結果が返ってくるので、確認してみましょう。
ちなみにこのときにa.outという実行ファイルも作成されます。

コードの提出

コードを提出する準備が整ったら提出を行います。

提出したいコードをエディタ上で開いた状態で”b.提出”をクリックします。
提出してよいか確認されるので、よければ”y”を間違えたなら”y以外のキー”を押します。ここで”y”を押すと取り消すことは出来ず提出されるのでコンテスト中などは慎重に行ってください。

提出するとターミナルに色々と表示されてAtCoderの提出ページが開かれます。そこで結果を確認しましょう。

Webサイトを開く時、もしかしたらエディタのポップアップが表示されるかもしれません。
その場合は”信頼されているドメインの構成”を選択します。

続いてエディタ上方に表示される”https://atcoder.jpを信頼する”などを選択すれば、以降提出時に確認されることはなくなります。

“信頼されているドメインの管理”を選ぶとTrusted Domainsという設定が開かれ、全ての信頼しているドメインを確認することが出来ます。

ログイン状態の確認

このコンテナ環境に接続されるたびにログイン確認を行うようになっているので、あまり使わないかもしれませんが、コンテスト直前などのタイミングでログインを確認しておきたいときに使用できます。

ログインの詳細はこちらを御覧ください。

タスク”D.ログイン”を実行した時、acc、oj共にログインしていたら下の画像のように表示されますが、ログインしていなかった場合ログインを促されます。