Ecosyste.ms: Awesome
An open API service indexing awesome lists of open source software.
https://github.com/kanglin/lunarcalendar
:cn: 用 Qt 写的中国农历日期库
https://github.com/kanglin/lunarcalendar
calendar chinesecalendar lunar lunarcalendar qt
Last synced: 3 months ago
JSON representation
:cn: 用 Qt 写的中国农历日期库
- Host: GitHub
- URL: https://github.com/kanglin/lunarcalendar
- Owner: KangLin
- License: gpl-3.0
- Created: 2019-03-26T08:38:56.000Z (almost 6 years ago)
- Default Branch: master
- Last Pushed: 2024-09-14T05:05:33.000Z (5 months ago)
- Last Synced: 2024-10-11T01:44:52.561Z (4 months ago)
- Topics: calendar, chinesecalendar, lunar, lunarcalendar, qt
- Language: C++
- Homepage:
- Size: 6.32 MB
- Stars: 24
- Watchers: 5
- Forks: 4
- Open Issues: 0
-
Metadata Files:
- Readme: README.md
- Changelog: ChangeLog.md
- Funding: .github/FUNDING.yml
- License: License.md
- Authors: Authors.md
Awesome Lists containing this project
README
## LunarCalendar
Author: Kang Lin
------------------------------------------------
[:cn: 中文](README_zh_CN.md)
- Project position:
- The main repository: https://github.com/KangLin/LunarCalendar
- Mirror repository:
- https://gitee.com/kl222/LunarCalendar
- https://gitlab.com/kl222/LunarCalendar
- https://sourceforge.net/projects/lunarcalendar/
- https://invent.kde.org/kanglin/LunarCalendar
- https://launchpad.net/lunarcalendar
- https://bitbucket.org/kl222/lunarcalendar
- [Project home](https://kanglin.github.io/LunarCalendar/html/index.html)
------------------------------------------------
- [](https://kanglin.github.io/LunarCalendar/html/index.html)
- master
[](https://github.com/KangLin/LunarCalendar/actions/workflows/build.yml)
[](https://ci.appveyor.com/project/KangLin/lunarcalendar/branch/master)
- develop
[](https://github.com/KangLin/LunarCalendar/actions/workflows/build.yml)
[](https://ci.appveyor.com/project/KangLin/lunarcalendar/branch/develop)
[](https://star-history.com/#KangLin/LunarCalendar&Date)
[](https://gitee.com/kl222/LunarCalendar/stargazers)
[](https://github.com/KangLin/LunarCalendar/forks)
[](https://github.com/KangLin/LunarCalendar/issues)
[](https://github.com/KangLin/LunarCalendar/releases)
[](https://github.com/KangLin/LunarCalendar/releases)
[](https://sourceforge.net/projects/lunarcalendar/files/latest/download)
------------------------------------------------
### Table of Contents:
- [Features](#Features)
- [Download setup package](#Download-setup-package)
- [Donation](#Donation)
- [Screenshots](#Screenshots)
- [Compile](#Compile)
- [Other application use the library](#Other-application-use-the-library)
- [Contribution](#Contribution)
- [License Agreement](#License-Agreement)
- [The third-party libraries](#The-third-party-libraries)
------------------------------------------------
### Features
The lunar calendar written by Qt. It provides:
- A lunar calendar library of Qt GUI, support QSS.
+ Solar calendar
+ Lunar calendar
+ Solar and Lunar holiday(eg: chinese holidays. solar term etc.)
+ Solar and Lunar anniversary (eg: birthday, wedding anniversary, etc.)
+ User-defined task prompts on the calendar (Displayed with highlighted dots)
+ ToolTip shows detailed tooltip content
+ Month view
+ Week view
- Example
+ A simple calendar app. Used to illustrate how to use this lunar calendar library.
+ A complete application of this library [Calendar](https://github.com/KangLin/Calendar)
- Cross-platform, support multiple operating systems.
See: [Qt5 supported platforms](https://doc.qt.io/qt-5/supported-platforms.html), [Qt6 supported platforms](https://doc.qt.io/qt-6/supported-platforms.html).
+ [x] Windows
+ [x] Linux、Unix
+ [x] Android
+ [x] Mac os
+ [ ] IOS
Mac os and IOS, I don't have the corresponding equipment,
please compile and test the students with the corresponding equipment.
### Donation
[](https://gitee.com/kl222/RabbitCommon/raw/master/Src/Resource/image/Contribute.png "donation")
### Screenshots
- Windows
- Ubuntu
- Android
- Task
### [Download setup package](https://github.com/KangLin/LunarCalendar/releases/latest)
- Develop library: *.zip
- Example program installation package:
- Ubuntu: *.deb
- Windows: *.exe
- Android: *.apk
- Documents: [LunarCalendar_v1.0.4_document.zip](https://github.com/KangLin/LunarCalendar/releases/download/v1.0.4/LunarCalendar_v1.0.4_document.zip)
### Compile
- Depend
+ [Qt (LGPL v2.1)](http://qt.io/)
+ [RabbitCommon](https://github.com/KangLin/RabbitCommon)
```
git clone https://github.com/KangLin/RabbitCommon.git
```
- Create and enter the build directory
git clone --recursive https://github.com/KangLin/LunarCalendar.git
cd LunarCalendar
mkdir build
- Use cmake
- linux
cd build
cmake .. -DCMAKE_INSTALL_PREFIX=`pwd`/install \
-DCMAKE_BUILD_TYPE=Release \
-DQt5_DIR=${QT_ROOT}/lib/cmake/Qt5 \
-DRabbitCommon_DIR=
cmake --build . --config Release --target install
- windows
cd build
cmake .. -DCMAKE_INSTALL_PREFIX=`pwd`/install ^
-DCMAKE_BUILD_TYPE=Release ^
-DQt5_DIR=${QT_ROOT}/lib/cmake/Qt5 ^
-DRabbitCommon_DIR=
cmake --build . --config Release --target install
- Android
- The host is linux
cd build
# If is Qt6
cmake .. -DCMAKE_BUILD_TYPE=Release \
-DCMAKE_INSTALL_PREFIX=`pwd`/android-build \
-DCMAKE_TOOLCHAIN_FILE=${ANDROID_NDK}/build/cmake/android.toolchain.cmake \
-DANDROID_ABI="armeabi-v7a with NEON" \
-DANDROID_PLATFORM=android-18 \
-DQT_DIR= \
-DQt6_DIR= \
-DRabbitCommon_DIR=
cmake --build . --target all
# If is Qt5
cmake .. -DCMAKE_BUILD_TYPE=Release \
-DCMAKE_INSTALL_PREFIX=`pwd`/android-build \
-DCMAKE_TOOLCHAIN_FILE=${ANDROID_NDK}/build/cmake/android.toolchain.cmake \
-DANDROID_ABI="armeabi-v7a with NEON" \
-DANDROID_PLATFORM=android-18 \
-DQT_DIR= \
-DQt5_DIR= \
-DRabbitCommon_DIR=
cmake --build . --config Release --target install
cmake --build . --target APK
- The host is windows
cd build
; If is Qt5
cmake .. -G"Unix Makefiles" ^
-DCMAKE_BUILD_TYPE=Release ^
-DCMAKE_INSTALL_PREFIX=`pwd`/android-build ^
-DCMAKE_TOOLCHAIN_FILE=${ANDROID_NDK}/build/cmake/android.toolchain.cmake ^
-DCMAKE_MAKE_PROGRAM=${ANDROID_NDK}/prebuilt/windows-x86_64/bin/make.exe ^
-DANDROID_PLATFORM=android-18 ^
-DANDROID_ABI=arm64-v8a ^
-DANDROID_ARM_NEON=ON ^
-DQT_DIR= ^
-DQt5_DIR= ^
-DRabbitCommon_DIR=
cmake --build . --config Release --target install
cmake --build . --target APK
; If is Qt6
cmake .. -G"Unix Makefiles" ^
-DCMAKE_BUILD_TYPE=Release ^
-DCMAKE_INSTALL_PREFIX=`pwd`/android-build ^
-DCMAKE_TOOLCHAIN_FILE=${ANDROID_NDK}/build/cmake/android.toolchain.cmake ^
-DCMAKE_MAKE_PROGRAM=${ANDROID_NDK}/prebuilt/windows-x86_64/bin/make.exe ^
-DANDROID_PLATFORM=android-18 ^
-DANDROID_ABI=arm64-v8a ^
-DANDROID_ARM_NEON=ON ^
-DQT_DIR= ^
-DQt6_DIR= ^
-DRabbitCommon_DIR=
cmake --build . --target all
- Parameter Description: https://developer.android.google.cn/ndk/guides/cmake
+ ANDROID_ABI: The following values can be taken:
Goal ABI. If the target ABI is not specified, CMake uses armeabi-v7a by default.
Valid ABI are:
- armeabi：CPU with software floating point arithmetic based on ARMv5TE
- armeabi-v7a：ARMv7-based device with hardware FPU instructions (VFP v3 D16)
- armeabi-v7a with NEON：Same as armeabi-v7a, but with NEON floating point instructions enabled. This is equivalent to setting -DANDROID_ABI=armeabi-v7a and -DANDROID_ARM_NEON=ON.
- arm64-v8a：ARMv8 AArch64 Instruction Set
- x86：IA-32 Instruction Set
- x86_64 - x86-64 Instruction Set
+ ANDROID_NDK The path of installed ndk in host
+ ANDROID_PLATFORM: For a full list of platform names and corresponding Android system images, see the [Android NDK Native API] (https://developer.android.google.com/ndk/guides/stable_apis.html)
+ ANDROID_ARM_MODE
+ ANDROID_ARM_NEON
+ ANDROID_STL: Specifies the STL that CMake should use.
- c++_shared: The shared library variant of libc++.
- c++_static: The static library variant of libc++.
- none: No C++ standard library support.
- system: The system STL
- Install apk to devices
adb install android-build-debug.apk
- Note:
before v1.0.4 and qt6
+ windows
If you build app. Qt does not provide openssl dynamic library for copyright reasons, so you must copy the dynamic library of openssl to the installation directory.
- If it is 32, you can find the dynamic library of openssl (libeay32.dll, ssleay32.dll) in the Qt installer Tools\QtCreator\bin directory.
- If it is 64-bit, you will need to download the binary installation package for openssl yourself.
+ linux
```
sudo apt-get install libssl1.1
```
### Develop
- [Online documents](https://kanglin.github.io/LunarCalendar/html/index.html)
- Directory
```
|-App application source code
|-Src calendar library source code
|- LunarCalendar.h calendar interface header file
|- Resource
|- database
|- chinese_holidays.sql chinese holidays sql
```
### Other application use the library
- Direct use the library source code.
+ cmake
- Submodule
+ add submodule:
git submodule add https://github.com/KangLin/LunarCalendar.git 3th_lib/LunarCalendar
git submodule update --init --recursive
+ Add follow code in CMakeLists.txt
add_subdirectory(3th_lib/LunarCalendar/Src)
- No submodule
+ Download LunarCalendar source code from https://github.com/KangLin/LunarCalendar
git clone --recursive https://github.com/KangLin/LunarCalendar.git
+ Add follow code in CMakeLists.txt
set(LunarCalendar_DIR $ENV{LunarCalendar_DIR} CACHE PATH "Set LunarCalendar source code root directory.")
if(EXISTS ${LunarCalendar_DIR}/Src)
add_subdirectory(${LunarCalendar_DIR}/Src ${CMAKE_BINARY_DIR}/LunarCalendar)
else()
message("1. Please download LunarCalendar source code from https://github.com/KangLin/LunarCalendar")
message(" ag:")
message(" git clone https://github.com/KangLin/LunarCalendar.git")
message("2. Then set cmake value or environment variable LunarCalendar_DIR to download root directory.")
message(" ag:")
message(FATAL_ERROR " cmake -DLunarCalendar_DIR= ")
endif()
+ Add libraries and include in CMakeLists.txt
SET(APP_LIBS ${PROJECT_NAME} ${QT_LIBRARIES})
if(TARGET LunarCalendar)
target_compile_definitions(${PROJECT_NAME}
PRIVATE -DLunarCalendar)
target_include_directories(${PROJECT_NAME}
PRIVATE "${LunarCalendar_DIR}/Src"
"${LunarCalendar_DIR}/Src/export")
set(APP_LIBS ${APP_LIBS} LunarCalendar)
endif()
target_link_libraries(${PROJECT_NAME} ${APP_LIBS})
- Use in library mode
+ cmake
- Cmake parameter LunarCalendar_DIR specifies the installation root directory
find_package(LunarCalendar)
- Add libraries and include in CMakeLists.txt
SET(APP_LIBS ${PROJECT_NAME} ${QT_LIBRARIES})
if(LunarCalendar_FOUND)
target_compile_definitions(${PROJECT_NAME}
PRIVATE -DLunarCalendar)
target_include_directories(${PROJECT_NAME}
PRIVATE "${LunarCalendar_INCLUDE_DIRS}/Src"
"${LunarCalendar_INCLUDE_DIRS}/Src/export")
set(APP_LIBS ${APP_LIBS} ${LunarCalendar_LIBRARIES})
endif()
target_link_libraries(${PROJECT_NAME} ${APP_LIBS})
### Contribution
- [Question](https://github.com/KangLin/LunarCalendar/issues)
- [Contributors](https://github.com/KangLin/LunarCalendar/graphs/contributors)
### [License Agreement](License.md "License.md")
Please follow the license agreement for the third-party libraries below and the license and thank the authors of the third-party libraries.
#### The third-party libraries
- [sxtwl_cpp](https://github.com/yuangu/sxtwl_cpp)
#### Other projects using this project
- [Calendar](https://github.com/KangLin/Calendar)