Skip to content

Latest commit

 

History

History
81 lines (61 loc) · 3.3 KB

develop-logseq-on-windows.md

File metadata and controls

81 lines (61 loc) · 3.3 KB

Build Logseq Desktop on Windows

Intro

This is a guide on creating Logseq development environment on Windows with PowerShell. Non-platform specific instructions like Develop Logseq should also be referenced.

Pre-requisites

(updated 20230221. May confirm via JAVA_VERSION and NODE_VERSION in THIS FILE)

An example of installing pre-requisites on Windows

  • Install Chocolatey
  • Install JRE (only x64, x32 will not work)
  • Install NVM for Windows, Node.js, and Yarn
    choco install nvm
    nvm install 18.12.0 (or whatever version)
    nvm use 18.12.0
    npm install -g yarn
    nvm use 18.12.0
    
  • Install clj-on-windows

Congrats! The pre-requisites are ready.

Set-up development environment (web app)

The basic idea is replacing the clojure commands in package.json to clj. Go to your cloned Logseq repo. Then install dependencies, execute the clj equivalent of yarn watch. Refer THIS if you want to setup proxy in PowerShell.

  • Copy files in resources to static

  • Compile static assets(css, icons...)

    yarn add --dev gulp
    yarn
    yarn gulp:watch
    
  • Open another powershell window, and run yarn cljs:watch. Clojure CLI will pull dependencies from Maven and Clojars, build the app and start the development server. Refer THIS if your network access to Maven and Clojars is unstable.

Now you can access the app via http://localhost:3001 and all changes to the code will be watched.

Set-up development environment (desktop)

To run the desktop app in development mode, after setting up web app development environment, run following commands which are equivalent to yarn dev-electron-app:

cd static
yarn
yarn electron:dev

The desktop app should pop-up on your screen.

During the build process node-gyp may complain that it cannot find Visual Studio. Try building the app in Developer Powershell for VS(shipped with Visual Studio). If this does not work for you, This issue may be helpful.

An example of setting up proxy in PowerShell

$env:GLOBAL_AGENT_HTTPS_PROXY='http://<proxy-host>:<proxy-port>'
$env:ELECTRON_GET_USE_PROXY='true'
$env:HTTPS_PROXY='http://<proxy-host>:<proxy-port>'
$env:HTTP_PROXY='http://<proxy-host>:<proxy-port>'

Set up Clojure CLI repository mirror

add the following pair to deps.edn:

:mvn/repos {
  "central" {:url "https://maven.aliyun.com/repository/public"}
  "clojars" {:url "https://mirrors.tuna.tsinghua.edu.cn/clojars"}
}

The mirrors above are friendly to Chinese developers(with bad network), developers with self-hosted repositories can use their own services.