Lời mở đầu

Trong bài viết trước mình đã có giới thiệu qua việc thêm source code C vào layer và build trên phương thức Makefile. Ở bài viết này mình sẽ tiếp tục build sử dụng phương thức CMake. Phương pháp này được khuyên dùng, và nhiều mẫu dự án sau này được xây bằng CMake.

Tóm tắt lý thuyết build sử dụng phương thức CMake

Bước 1: Tạo layer HelloWorld_CMake và recipe

Bước 2: Tạo CMake để build source code HelloWorld.

Trong bước này mình sẽ đề cập đến phần kiến thức nhanh về CMake

Build file c hellworld đơn giản

Trước tiên chúng ta hãy tải cmake về máy bằng câu lệnh sau:

**~/**
sudo apt install cmake

Tạo folder để lưu trữ source code

**~/**
mkdir cmake_practice

Tạo file c có tên: helloworld

**~/cmake_practice/helloworld.c**
#include<iostream>

int main(int argc, char *argv[]){
   std::cout << "Hello World with CMake!" << std::endl;
   return 0;
}

File CMakeLists.txt

**~/cmake_practice/CMakeLists.txt**
cmake_minimum_required(VERSION 2.8.9)
project (hello)
add_executable(hello helloworld.c)

Về cơ bản một nội dung file CMake chỉ có ba dòng đủ để build một file c.

Ở dòng đầu tiên yêu cầu về verion của CMake
- Bạn muốn xem được version hiện tại bao nhiêu chỉ cần chạy câu lệnh:
- ```
**~/cmake_practice**
cmake --version
```
Dòng thứ hai khai báo tên dự án
Dòng thứ ba gồm có 2 tham số truyền vào hàm (tên file thực thi, tên file nguồn)

Thực hiện build file c bằng câu lệnh sau:

**~/cmake_practice**
cmake .
ls

**Output**
CMakeCache.txt  cmake_install.cmake  helloworld.c
CMakeFiles      CMakeLists.txt       Makefile

Thông qua bước trên, chúng ta nhận thấy có một số file mới xuất hiện nhưng ta chưa thấy file execute nằm ở đâu. Lí do là CMake chỉ tạo ra các file config cần thiết để chuẩn bị cho quá trình biên dịch, đặc biệt file Makefile. File Makefile này chứa các hướng dẫn chi tiết cho quá trình biên dịch (build) và (linking) source code của bạn thành một file execute.

Vì vậy, để tạo file execute cuối cùng, bạn cần chạy lệnh:

**~/cmake_practice**
make

Sau khi chạy lệnh make, file thực thi sẽ được tạo ra. Bạn có thể thấy nó trong thư mục hiện tại.

**~/cmake_practice**
./helloworld

Build source code gồm có file header và file C

Cấu trúc thư mục:

**~/cmake_practice/inclue/person.h**
#ifndef PERSON_H
#define PERSON_H

void print_name(void);

#endif

**~/cmake_practice/src/person.c**
#include <stdio.h>
#include "person.h"

void print_name(void) {
        printf("My name is Nhat!");
}

**~/cmake_practice/src/main.c**
#include "person.h"

int main(void) {
        print_name();
}

**~/cmake_practice/src/CMakeLists.txt**
cmake_minimum_required(VERSION 2.8.9)
project(person)

include_directories(include)
file(GLOB SOURCES "src/*.cpp")
add_executable(testStudent ${SOURCES})

So với ví dụ trên, file CMake sẽ có những thay đổi sau:

Thêm thư mục chứa file header: Chúng ta sử dụng lệnh include_directories() để chỉ ra vị trí của các file header mà chương trình cần.
Thiết lập danh sách file nguồn: Thay vì chỉ định từng file c cụ thể, ta có thể sử dụng lệnh set(SOURCES ...) hoặc GLOB để tự động gom tất cả các file nguồn vào biến SOURCES.
Sử dụng biến SOURCES cho add_executable: Ở ví dụ đầu tiên, chúng ta chỉ định trực tiếp tên file c. Trong ví dụ này, ta dùng biến SOURCES để truyền toàn bộ danh sách file nguồn cho add_executable.

Thực hiện build và chạy file thực thi

**~/cmake_practice**
cmake ..
make
./person

**Output**
My name is Eric!

Bước 3: Tạo ra file bb mới

Bước 4: Khởi tạo môi trường và build source code recipe

Thực hành thêm chương trình C sử dụng phương thức CMake

Bước 1: Tạo recipe cho dự án

Tạo một thư mục mới có tên recipes-helloworld-cmake nằm trong layer meta-customize

**~/poky/build**
cd ../meta-customize
mkdir recipes-helloworld-cmake/
cd recipes-helloworld-cmake/

Tạo thư mục mới chứa file bb trong recipes với tên hellowolrd và version là c

**~/poky/meta-customize/recipes-helloworld-cmake**
mkdir helloworld-c
cd helloworld-c

Tạo thêm thư mục con nằm trong recipes-helloworld-cmake để chứa source code

**~/poky/meta-customize/recipes-helloworld-cmake**
mkdir helloworld
cd helloworld

Bước 2: Tạo CMake để build source code HelloWorld.

Đầu tiên chúng ta tạo ra 3 file helloworld.h, helloworld.c và main.c

**~/poky/meta-customize/recipes-helloworld-cmake/helloworld**
mkdir src include
touch CMakeLists.txt src/main.c src/helloworld.c include/helloworld.h

Tiếp theo viết nội dung cho các file.

**~/poky/meta-customize/recipes-helloworld-cmake/helloworld/helloworld.h**
#ifndef HELLOWORLD_H
#define HELLOWORLD_H

void print_hello(void);

#endif

**~/poky/meta-customize/recipes-helloworld-cmake/helloworld/helloworld.c**
#include <stdio.h>
#include "hello.h"

void print_hello() {
    printf("Hello World with CMake\n");
}

**~/poky/meta-customize/recipes-helloworld-cmake/helloworld/main.c**
#include "hello.h"detailed explanation

int main() {
    print_hello();
    return 0;
}

Tiếp tục ta sẽ tạo ra CMake và viết nội dung cho nó

**~/poky/meta-customize/recipes-helloworld-cmake/helloworld/CMakeLists.txt**
cmake_minimum_required(VERSION 2.8.9)
project(helloworld)

include_directories(include)
file(GLOB SOURCES "src/*.c")
add_executable(testHelloWorld ${SOURCES})

Cấu trúc cây thư mục:

Tiếp chúng ta để tránh lỗi xảy trong quá trình biên dịch khi dùng bitbake, ta nên thử build source này bằng cmake xem có lỗi gì hay không. Tạo thư mục test tạm thời và dùng lệnh cmake.

**~/poky/meta-customize/recipes-helloworld-cmake/helloworld**
mkdir test
cmake ..
make
./helloworld

**Output**
Helloworld with cmake!

Bước 3: Tạo ra file bb mới

**~/poky/meta-customize/recipes-helloworld-cmake/helloworld**
cd ..
nano helloworld-c.bb

**~/poky/meta-customize/recipes-helloworld-cmake/helloworld/helloworld-c.bb**
SUMMARY = "helloworld of cmake recipe"
DESCRIPTION = "My hello world application"
LICENSE = "CLOSED"

inherit cmake

FILESEXTRAPATHS_prepend := "${THISDIR}/:"
SRC_URI = "file://helloworld/"

S = "${WORKDIR}/helloworld"
FILES_${PN} = "${bindir}/"

Bước 4: Khởi tạo môi trường và build source code recipe

#user@localhost:~/poky/
source oe-init-build-env
bitbake helloworld-c

Cài đặt các gói recipe vào image

Mở tệp cấu hình local.conf và cài đặt gói recipe vào image

**~/poky/build**
nano conf/local.conf

**~/poky/build/conf/local.conf**
IMAGE_INSTALL += "helloworld-c"

Build lại image để cập nhật

**~/poky/build**
bitbake core-image-minimal

Kiểm tra đã cập nhật recipe trong rootfs hay chưa

**~/poky/build**
ls tmp/work/qemux86_64-poky-linux/core-image-sato/1.0-r0/rootfs/usr/bin/helloworld-c

Chạy thử trên QEMU