(Cyberworlds was the code name for Alpine's codebase.)
This repository preserves Alpine’s source code as a historical archive. There will be no ongoing maintenance, support, or security updates.
To develop for Cyberworlds, run the following after you've cloned the repo:
./admin/bin/devWe use Bazel which installs all the tools you need. Including Node.js and package managers like pnpm.
We recommend the following setup steps as well:
-
Add
./admin/binto yourPATHenvironment variable. This will let you rundevfrom anywhere without specifying the path. We also include wrappers for tools likenodeandpnpm. While in thecyberworldsdirectory these wrappers will run the version of the tool installed by Bazel. Outside ofcyberworldsthese wrappers will run the system installed version of the tool.Example: Add the line
export PATH=$HOME/cyberworlds/admin/bin:$PATHto your~/.bashrcor~/.zshrcfile (depending on which you use) and replace$HOMEwith the directory you cloned the git repo to. -
Run
pnpm installin the Cyberworlds directory. Bazel will installnode_moduleswhen building your project but in the Bazel build directory. If you want access tonode_modulesat the repo root (which is necessary for IDE integrations with tools like TypeScript, ESLint, and Prettier) you need to runpnpm install. -
If you use Chrome as your web browser, go to
chrome://inspectand under the “Devices” section click “Configure” next to “Discover network targets”. Addlocalhost:3001,localhost:3011,localhost:3021,localhost:3031,localhost:3039,localhost:3041,localhost:3051,localhost:3061, andlocalhost:3071. These are the ports our development mode services will expose for launching a JavaScript inspector. See.env.developmentfor configuring these ports.
- If you want to test uploading Microsoft Office documents (Word, Excel, and PowerPoint) you'll need to install LibreOffice on your system.
Error message while running dev: Could not determine Xcode version at all. This likely
means Xcode isn't available
If while running dev you get an error that looks like:
ERROR: /private/var/tmp/_bazel_desireedewysocki/7506582f4dbb88fa39d760e6a6d0b447/external/local_config_apple_cc/BUILD:79:24: in cc_toolchain_config rule @local_config_apple_cc//:darwin_x86_64:
Traceback (most recent call last):
File "/private/var/tmp/_bazel_desireedewysocki/7506582f4dbb88fa39d760e6a6d0b447/external/local_config_apple_cc/cc_toolchain_config.bzl", line 2465, column 58, in _impl
enabled = xcode_support.is_xcode_at_least_version(xcode_config, "15.0.0"),
File "/private/var/tmp/_bazel_desireedewysocki/7506582f4dbb88fa39d760e6a6d0b447/external/build_bazel_apple_support/lib/xcode_support.bzl", line 35, column 13, in _is_xcode_at_least_version
fail("Could not determine Xcode version at all. This likely means Xcode isn't available; " +
Error in fail: Could not determine Xcode version at all. This likely means Xcode isn't available; if you think this is a mistake, please file an issue.
ERROR: /private/var/tmp/_bazel_desireedewysocki/7506582f4dbb88fa39d760e6a6d0b447/external/local_config_apple_cc/BUILD:79:24: Analysis of target '@local_config_apple_cc//:darwin_x86_64' failed
WARNING: errors encountered while analyzing target '//admin/dev:dev': it will not be built
ERROR: command succeeded, but not all targets were analyzed
FAILED: Build did NOT complete successfully
ERROR: Build failed. Not running target
Double check that XCode is installed and that you can run it. First check your Applications folder for XCode and if it’s not there open the MacOS App Store and make sure it’s installed from there.
Then try running the following (from this StackOverflow answer) which will make sure XCode CLI tools are working:
bazel clean --expunge
sudo xcode-select -s /Applications/Xcode.app/Contents/Developer
sudo xcodebuild -license
bazel clean --expungeTry running dev again after this.