👨‍🍳 Build Recipe

This commit is contained in:
ful1e5 2020-08-12 11:03:46 +05:30
commit 7019c40337
2 changed files with 76 additions and 22 deletions

View file

@ -11,6 +11,7 @@ and this project adheres to [Semantic Versioning](https://semver.org/spec/v2.0.0
- `Windows Cursors Info` added in `src/svg/README.md` ([14d85f7](https://github.com/ful1e5/apple_cursor/commit/14d85f7ed289d681685e698eae4d0f205b6a3f3a)) - `Windows Cursors Info` added in `src/svg/README.md` ([14d85f7](https://github.com/ful1e5/apple_cursor/commit/14d85f7ed289d681685e698eae4d0f205b6a3f3a))
- Quick install and Build Docs Improved - Quick install and Build Docs Improved
- Color palette Icons Chnaged to Semi-Circle
- Window **Config** Sorted ([acbbea2](https://github.com/ful1e5/apple_cursor/commit/acbbea24238fbfd43b405e4af73cc9f8b0101a59)) - Window **Config** Sorted ([acbbea2](https://github.com/ful1e5/apple_cursor/commit/acbbea24238fbfd43b405e4af73cc9f8b0101a59))
### Added ### Added

View file

@ -87,7 +87,10 @@ Enjoy upcoming **[macOS BigSur](https://www.apple.com/macos/big-sur-preview/)**
- [Build Dependencies](#build-dependencies) - [Build Dependencies](#build-dependencies)
- [Build From Scrach](#build-from-scratch) - [Build From Scrach](#build-from-scratch)
- [⚡ Auto Build (using GitHub Actions)](#⚡-auto-build-using-gitHub-actions) - [⚡ Auto Build (using GitHub Actions)](#⚡-auto-build-using-gitHub-actions)
- [Manual Build](#manual-build) - [Manual build](#manual-build)
- [Setup Python Environment](#setup-python-environment)
- [Compile Theme using yarn](#using-yarn)
- [Compile Theme using npm](#using-npm)
- [Install Build Theme](#install-build-theme) - [Install Build Theme](#install-build-theme)
- [Bugs](#bugs) - [Bugs](#bugs)
- [Getting Help](#getting-help) - [Getting Help](#getting-help)
@ -112,14 +115,14 @@ Enjoy upcoming **[macOS BigSur](https://www.apple.com/macos/big-sur-preview/)**
#### Colors #### Colors
![#13A3F5](https://placehold.it/15/13A3F5/000000?text=+) ![#13A3F5](https://imgur.com/m0JhD7W.png)
![#4DCB2C](https://placehold.it/15/4DCB2C/000000?text=+) ![#4DCB2C](https://imgur.com/wtyqDHv.png)
![#FED103](https://placehold.it/15/FED103/000000?text=+) ![#FED103](https://imgur.com/5km5GW6.png)
![#FE9D0C](https://placehold.it/15/FE9D0C/000000?text=+) ![#FE9D0C](https://imgur.com/Gx2eGbm.png)
![#F2493C](https://placehold.it/15/F2493C/000000?text=+) ![#F2493C](https://imgur.com/hl22EPB.png)
![#B75DCC](https://placehold.it/15/B75DCC/000000?text=+) ![#B75DCC](https://imgur.com/wev8rfw.png)
![#000000](https://placehold.it/15/000/000000?text=+) ![#000000](https://imgur.com/24cocpe.png)
![#fffff](https://placehold.it/15/fff/000000?text=+) ![#fffff](https://imgur.com/YyhMKNT.png)
#### Quick install #### Quick install
@ -185,46 +188,96 @@ sudo mv macOSBigSur /usr/share/icons/
#### Install Runtime Dependencies #### Install Runtime Dependencies
##### macOS
```bash
brew cask install xquartz libpng
```
##### Debain/ubuntu ##### Debain/ubuntu
```bash ```bash
sudo apt install libx11-dev libxcursor-dev libpng-dev sudo apt install libx11-dev libxcursor-dev libpng-dev
``` ```
##### ArchLinux/Manjaro ##### ArchLinux/Manjaro
```bash ```bash
sudo pacman -S libx11 libxcursor libpng sudo pacman -S libx11 libxcursor libpng
``` ```
##### Fedora/Fedora Silverblue/CentOS/RHEL ##### Fedora/Fedora Silverblue/CentOS/RHEL
```bash ```bash
sudo dnf install libx11-devel libxcursor-devel libpng-devel sudo dnf install libx11-devel libxcursor-devel libpng-devel
``` ```
## Build Dependencies ## Build Dependencies
- nodejs (<=12.x.x) - [nodejs](https://nodejs.org/en/) (<=12.x.x)
- yarn - [yarn](https://classic.yarnpkg.com/en/docs/install/) / [npm](https://docs.npmjs.com/cli/install.html)
- python (<=3.6) - [python](https://www.python.org/downloads/) (<=3.6)
- pip3 - [pip3](https://pip.pypa.io/en/stable/installing/)
### Node Packages
#### devDependencies
- [@types/puppeteer](https://www.npmjs.com/package/@types/puppeteer)
- [nodemon](https://www.npmjs.com/package/nodemon)
- [ts-node](https://www.npmjs.com/package/ts-node)
- [tslint](https://www.npmjs.com/package/tslint)
- [typescript](https://www.npmjs.com/package/typecript)
#### dependencies
- [puppeteer](https://www.npmjs.com/package/puppeteer)
### PyPi Packages
- [clickgen](https://pypi.org/project/clickgen/s)
- [Pillow](https://pypi.org/project/Pillow/)
## Build From Scratch ## Build From Scratch
> Make sure you have installed all [Build dependencies](#build-dependencies).
### ⚡ Auto Build (using GitHub Actions) ### ⚡ Auto Build (using GitHub Actions)
GitHub Actions is automatically runs on every `push`(on **master** and **dev** branches) and `pull request`(on **master** branch), You found theme resources in `artifact` section of **build**.GitHub **Actions** available inside [.github/workflows](https://github.com/ful1e5/apple_cursor/tree/master/.github/workflows) directory. GitHub Actions is automatically runs on every `push`(on **master** and **dev** branches) and `pull request`(on **master** branch), You found theme resources in `artifact` section of **build**.GitHub **Actions** available inside [.github/workflows](https://github.com/ful1e5/apple_cursor/tree/master/.github/workflows) directory.
### Manual Build ### Manual Build
#### Setup python environment
```bash ```bash
# This command setup python virtual environment && install all packages python3 -m pip install --upgrade pip # Update pip to latest
yarn setup python3 -m pip3 install virtualenv # Install python virtual environment
# Build & Unpack built cursor theme virtualenv venv # Create new virtualenv named `venv`
yarn compile && yarn unpack source venv/bin/activate # Activate virtualenv
# For Deactivate virtualenv
deactivate
```
#### Compile From Source
> Make sure you followed [previous step](#setup-python-environment) and `virtualenv` is **active**.
##### Using yarn
```bash
yarn install # Install all Node Packages
yarn py_install # Install all PyPi Packages
yarn compile # Compile the cursor theme
yarn unpack # To extract`./packages/macOSBigSur.tar` file
```
##### Using npm
```bash
npm install # Install all Node Packages
npm py_install # Install all PyPi Packages
npm compile # Compile the cursor theme
npm unpack # To extract`./packages/macOSBigSur.tar` file
``` ```
After build `bitmaps` and `packages` are generated at project root directory. After build `bitmaps` and `packages` are generated at project root directory.