gtest_exercise/Readme.md

# OOP Exercise - Google Test

## 使用方法

clone 專案並進入專案目錄
```sh
git clone https://gitea.cglab.cs.nccu.edu.tw/yhchen/gtest_exercise.git
cd gtest_exercise
```
建立 build 目錄，所有編譯需要的檔案會被建立在這個目錄裡面
```sh
mkdir build
cd build
```
使用 cmake 建立 makefile，並編譯檔案
```sh
cmake ..
make
```
進入 `unittest` 目錄，如果有看到 `utest` 執行檔，代表編譯順利完成
```sh
cd unittest
./utest
```

## 練習內容
在 `src` 目錄中含有 `sphere` 物件的宣告及實作，但是這個程式碼中有一些邏輯錯誤，同學需完成以下步驟：
1. 編寫 unittest 使 sphere 程式碼覆蓋率達到 70% 以上
2. 修改 `sphere.cc` 程式碼，使程式的邏輯完全正確

## 覆蓋率計算
這個專案的 cmake 檔案包含計算覆蓋率的工具，會在編譯 `unittest` 及 `src` 目錄時同時產生覆蓋率統計的檔案在 `build/資料夾位置/CMakeFiles/專案名稱.dir/檔案名稱.cc.gcno`，在執行過程式之後，可以執行下列指令顯示覆蓋率

```sh
gcov <gcno檔位置>
```

在 macos 中，預設使用的內建 gcov 會無法開啟生成的檔案，需要使用 homebrew 安裝的 gcov（安裝 gcc 時會自動安裝），通常為 `gcov-12`，執行下列指令能夠檢查是否使用內建的 gcov
```sh
which gcov
```
如果輸出為 `/usr/bin/gcov`，就代表使用的是內建的 gcov。

## 附錄
### Linux 環境下安裝 cmake （以 ubuntu 為例）

若環境有需要，請自行加上 `sudo`

```sh
apt update
apt install g++ cmake
```
### Windows 環境下安裝 cmake

可以安裝 Windows Subsystem of Linux，並按照上述 Linux 的步驟操作

### MacOS 環境下安裝 cmake 

需先安裝 brew，安裝完成後執行

```sh
brew install gcc cmake
```

若使用的是 M1 mac，需要手動將 g++ 加入 PATH，請自行 google