From 6abe9127096bfabe34675e87c6944c032e12b5ea Mon Sep 17 00:00:00 2001 From: Connor Turland Date: Tue, 19 Jan 2021 03:49:12 -0500 Subject: [PATCH] Update README.md --- README.md | 156 +----------------------------------------------------- 1 file changed, 2 insertions(+), 154 deletions(-) diff --git a/README.md b/README.md index 4316a34..f7f3191 100644 --- a/README.md +++ b/README.md @@ -1,155 +1,3 @@ -# acorn-release +# iamp2p-release -A distributable version of the peer-to-peer [Acorn](https://github.com/h-be/acorn-docs) [holochain](https://holochain.org) system packaged as a native application for Linux and Mac. - -## Building and running Acorn 🎉 - -Acorn can be built and run on: - -- Mac OS X -- Ubuntu et al. linux flavours -- Nix (dev only) - -It can't run on Windows because holochain conductors don't run on Windows (yet). - -High level, there are a few ways to interact with Acorn from this repo: - -- Run it via a "packaged" electron installation built with `electron-packager` -- Built an aforementioned package for some target platform with `electron-packager` - -The different interactions work differently across mac/ubuntu/nix and generally -are NOT compatible with each other. - -Pick a workflow that you like and stick with it. - -### Bundling in versions of acorn-hc and acorn-ui - -These will need to be run, before other commands like "running" and "packaging" will succeed. -It needs to know which versions you want to be running or packaging. - -#### acorn-hc - -You can pass in a version number of an [acorn-hc](https://github.com/h-be/acorn-hc) release, like 0.3.6 - -```bash -nix-shell --run 'acorn-bundle-dna x.y.z' -``` - -or just use the latest default - -```bash -nix-shell --run acorn-bundle-dna -``` - -This will result in there being - -1. a `dna/profiles.dna.gz` file which contains the profiles WASM and full DNA -2. a `dna/projects.dna.gz` file which contains the projects WASM and full DNA - -#### acorn-ui - -You can pass in a version number of an [acorn-ui](https://github.com/h-be/acorn-ui) release, like 0.3.11 - -Just run - -```bash -nix-shell --run 'acorn-bundle-ui x.y.z' -``` - -or just use the latest default - -```bash -nix-shell --run acorn-bundle-ui -``` - -This will result in there being a `ui` folder locally, which contains all the html/css/js files for the user interface. - -### Running Acorn directly - -#### Nix - -Run `nix-shell --run acorn` - -### Run the package - -#### Mac OS X - -- Run `Acorn-darwin-x64/Acorn` - -#### Ubuntu - -- Run `Acorn-linux-x64/Acorn` - -#### Nix - -Not supported! :( - -Electron packager tries to ship its own version of electron, which is not nix friendly. - -### Packaging - -This will produce an Acorn.app file within `Acorn-$platform-$arch` folder. This can be zipped and shared. - -`main.js` is a primary point of development. - -#### Nix - -##### Mac - -**Signed and Notarized (Distribute as a Verified Developer)** - -To create a codesigned and notarized build depends on having purchased an Apple developer account and acquiring Apple Developer Certificates, so you will need to have special access to those to make this process work. - -Set the following environment variables, before running the following. - -``` -APPLE_DEV_IDENTITY=Developer ID Application: Happy Coders, Inc. (XYZABCNOP) -APPLE_ID_EMAIL=appledeveloperaccount@hAPPy-coders.com -APPLE_ID_PASSWORD=... -``` - -``` -nix-shell --run acorn-build-mac -``` - -To get extra details on this build process, or to debug, set the following environment variable: - -``` -DEBUG=electron-osx-sign*,electron-notarize* -``` - -This relates to the nodejs/npm package [debug](https://www.npmjs.com/package/debug). - -**Unsigned (Distribute as an Unverified Developer)** - -This version will require the special step that Mac Gatekeeper enforces, which is to allow unverified apps generally, -or to allow this specific app. This can be done by holding `ctrl` and clicking on the `Acorn` application, -and then clicking `Open`, and then `Open` when it asks about the Unidentified Developer. - -``` -nix-shell --run acorn-build-mac-unsigned -``` - -##### Linux - -For linux defaults, run - -``` -nix-shell --run acorn-build-linux -``` - -or for specific linux platform or arch - -``` -nix-shell --run "acorn-build $platform $arch" -``` - -## Authors - -- **Connor Turland** [Connoropolous](https://github.com/Connoropolous) -- **David Meister** -- **Sam Cooley** - -## License - -This project is licensed under the CAL-1.0 Beta 4, see [LICENSE.md](./LICENSE.md) for details. +A guided tour through p2p!