An update to making macOS standalones. #2881

adcxyz · 2017-05-21T17:49:13Z

Hi,
following @brianlheim asking about old standalone-related code, and requests to make my
related scripts official, I updated and tested my scripts for making simple OSX standalones.
They are now in the Guides help file proposed here, and could go into 3.9.

Please test and let me know about any snags, and add pointers to other related projects, such as @miguel-negrao 's work on the project feature.

best adc

LFSaw

I'd suggest a merge with

https://github.com/supercollider/supercollider/blob/master/HelpSource/Guides/standalones.schelp

especially the motivation section.

Also, we should discuss its location in the HelpSource directory (Tutorial? Guide?)

all in all I could not complete the review because of an error in step 3 (class did not compile successfully)

LFSaw · 2017-05-27T12:23:28Z

HelpSource/Guides/OSX_Standalones.schelp

+This Guide is for exporting copies of an existing SC3 setup,
+for at least two scenarios:
+
+A - Freezing an SC-based setup for non-expert users,


why not make this a list:: ?

LFSaw · 2017-05-27T12:23:47Z

HelpSource/Guides/OSX_Standalones.schelp

+This set of scripts creates a SuperCollider-based
+Standalone app in a few basic steps:
+
+1. copy the open SuperCollider.app or SC3-derived standalone.


why not make this a list::?

LFSaw · 2017-05-27T12:28:51Z

HelpSource/Guides/OSX_Standalones.schelp

+
+subsection:: What to prepare
+
+* have your system ready with all desired quarks installed,


would be great to have such a minimal startup file listing here... something like

s.waitForBoot{ { Line.kr(1, 0, 10, doneAction: 2) * SinOsc.ar(1000) * EnvGen.ar(Env.perc(0.01, 0.25), Impulse.kr(2), 0.1)!2 }.play; }

LFSaw · 2017-05-27T12:30:30Z

HelpSource/Guides/OSX_Standalones.schelp

+~newAppName = "Utopia_GenComp_39d";
+~newAppLocation = "~/Desktop".standardizePath;
+
+// some helper functions


maybe add
// nothing to be changed below this line

LFSaw · 2017-05-27T12:33:47Z

HelpSource/Guides/OSX_Standalones.schelp

+
+// 3. *** time for the first wakeup kiss *** //
+unixCmd("open" + ~pathToNewApp);
+


I got lots of

ERROR: duplicate Class found: 'BinaryOpXStream' [...] ERROR: There is a discrepancy. numClassDeps 3482 gNumClasses 4752 Library has not been compiled successfully. Library has not been compiled successfully.

maybe because I have a custom LanguageConfig file?

so I cannot test further...

hi @LFSaw,
Did I address all your requests in todays commits, or is anything still missing?
For the conflict, can you please test again whether it works now?
If your config is pointing to a git repo and not the internal classlib, things can go wrong.
So best to make a test config with internal classlib and help, plus a few quark includePaths.
thanks, adc

bagong · 2017-05-27T13:31:53Z

I'd suggest a merge with
https://github.com/supercollider/supercollider/blob/master/HelpSource/Guides/standalones.schelp
especially the motivation section.

Or just replace that version. It is not possible to open that guide in a sc-version that still supports the feature described there 😄 And I don't think anybody is able to run the SC-version required for the feature (3.4) let alone build it.

LFSaw · 2017-05-27T13:36:47Z

IMHO a mention of GPL in the standalone guide would be beneficial.

merged with standalones.schelp, pointed out GPL, lists done with list:: , added basic startup file example.

adcxyz · 2017-06-04T10:18:22Z

@LFSaw @bagong,
Thanks for all the helpful comments, addressed all of them!
I hope this is substantial enough now for a merge.

Unfortunately, one puzzling question came back again:
With the exact same app-to-export-from and exact same scripts (these), the new app
sometimes has the intended userAppSupportDir "Library/Application Support/",
sometimes it stills falls back to "Library/Application Support/SuperCollider"!
I have no reproducer for what circumstances make it one or the other ...

I would appreciate any hunches, ideas, hints for what could cause this ...
Thanks adc

and more explanatory comments and tests added

adcxyz · 2017-06-04T12:26:37Z

@LFSaw - could be in Tutorials or Guides, both is fine with me.

mossheim · 2017-06-05T14:40:50Z

I will take a look at this today! No idea re: userAppSupportDir, I will see if I can figure out anything about that. Thanks for all your work on this @adcxyz!

LFSaw · 2017-06-05T15:06:47Z

Unfortunately, I cannot have a close look atm... too much other things here. Hope someone else will jump in and try building a standalone. Great work anyhow!

nhthn

thanks! i'm not going to review this really thoroughly since you know what you're doing and a help file can't really hurt anyone anyway. but just to be safe, a few unix commands could be made less destructive so that someone experimenting with the code is less likely to shoot themselves in the foot.

nhthn · 2017-06-05T17:45:18Z

HelpSource/Guides/standalones.schelp

+code::
+/*
+// if it failed, delete the app
+unixCmd("rm -r" + quote(~pathToNewApp));


is there a safer alternative to rm -r? i think there's a way to move something to trash from the command line on mac, but you gotta install something

brew install trash, but idk, I think this could also just be prefixed by a check that ~pathToNewApp has a good value.

or rm -ir like you've suggested above—it'll check on each directory to be deleted rather than on each file

if pathToNewApp = "*" you get a pretty bad command, don't you?

There is File.delete(path), and path.pathMatch.

have a look at install, a really great alternative to mv and thelike...

nhthn · 2017-06-05T17:50:10Z

HelpSource/Guides/standalones.schelp

+};
+~writeText = { |path, string| File(path, "w").write(string).close; };
+~copyFolder = { |orig, dest|
+	var str = "cp -r" + quote(orig) + quote(dest);


nhthn · 2017-06-05T17:51:41Z

HelpSource/Guides/standalones.schelp

+	~pathsToCopy.do { |path|
+		unixCmd(
+			"cd" + quote(~newAppQuarksDir) ++ ";"
+			" cp -r" + quote(path).postln + ".");


have a look at install, a really great alternative to mv and thelike...

nhthn · 2017-06-05T17:51:46Z

HelpSource/Guides/standalones.schelp

+// b. rename the binary file:
+"renaming macos binary to: ".post;
+// fixups in the new app - 2. rename the binary inside the app folder
+unixCmd("mv"


adcxyz · 2017-06-06T06:45:27Z

OK, thanks for the tips!

the safest thing for the rm command is to replace it with user instructions to toss the app file ;-)
for the others, will look at install, and add safer flags.
best a

removed obsolete help file images.

nhthn

thanks!

mossheim

The code works perfectly on my machine, thank you so much for adding this material! There are two small issues I noticed; I think this can be merged once those are fixed.

mossheim · 2017-06-08T15:32:33Z

HelpSource/Guides/standalones.schelp

+	~pathsToCopy.do { |path|
+		unixCmd(
+			"cd" + quote(~newAppQuarksDir) ++ ";"
+			" cp -ir" + quote(path).postln + ".");


Here, I get a parse error. I think you need to add ++ to the end of the line above, possibly also a newline if that's what you were going for.

weird - I dont get a parse error here (3.9 dev). SO, I added the ++ as suggested just to make sure,
and it still runs fine.

mossheim · 2017-06-08T15:34:57Z

HelpSource/Guides/standalones.schelp


-	Customize the "Standalone Resources" directory, which is located at the root of the SuperCollider source directory. Any files you put in this directory will override the files originating from the SuperCollider source at the same destination.
+// TO PREPARE, CHECK YOUR CURRENT config in Preferences->Interpreter:


I think you intended this to go in the code:: block below; when rendered as-is this does not look well-formatted.

mossheim · 2017-06-08T16:20:22Z

Also, sorry it took me so long to look at this. I planned to give it a try Monday, but a friend visited unexpectedly :)

adcxyz · 2017-06-12T13:42:53Z

ok, done, ready to merge :-)

mossheim

awesome, thanks! parse error might have been because I was copy-pasting from the help window, so I got nbsp's (possibly CRLF? not sure)

telephon · 2017-06-12T16:36:20Z

thank you!

adcxyz · 2017-06-13T16:49:56Z

happy to have it finalized :-)

first commit of simple guide to standalones.

6cbcc8b

adcxyz added enhancement os: macOS labels May 22, 2017

vivid-synth added env: SCIDE comp: Qt GUI sclang Qt components -- for IDE tickets, use "env: SCIDE" instead labels May 22, 2017

improved packaging-in of Quarks.

c3af9ef

adcxyz changed the title ~~first commit of simple guide to standalones.~~ A simple guide to OSX standalones. May 26, 2017

improve consistency of naming.

bfeee60

LFSaw requested changes May 27, 2017

View reviewed changes

adcxyz added the Work In Progress (WIP) - don't merge yet label May 30, 2017

adcxyz self-assigned this May 30, 2017

Addressed all issues in the comments:

738bd9e

merged with standalones.schelp, pointed out GPL, lists done with list:: , added basic startup file example.

adcxyz removed the Work In Progress (WIP) - don't merge yet label Jun 4, 2017

adcxyz changed the title ~~A simple guide to OSX standalones.~~ An update to making mascOS standalones. Jun 4, 2017

adc added 2 commits June 4, 2017 13:29

improved plist/binary renaming, avoid port clash

cb1b154

and more explanatory comments and tests added

added note to use config with internal classlib

5b9ed5d

mossheim added this to the 3.9 milestone Jun 5, 2017

LFSaw approved these changes Jun 5, 2017

View reviewed changes

nhthn reviewed Jun 5, 2017

View reviewed changes

removed rm -r, added -i flag to cp and mv calls

b3a87d1

removed obsolete help file images.

LFSaw changed the title ~~An update to making mascOS standalones.~~ An update to making macOS standalones. Jun 6, 2017

nhthn approved these changes Jun 6, 2017

View reviewed changes

mossheim suggested changes Jun 8, 2017

View reviewed changes

fix layout detail and script as requested

1cacdd0

mossheim approved these changes Jun 12, 2017

View reviewed changes

mossheim merged commit 43b5762 into master Jun 12, 2017

mossheim deleted the topic-guide-standalone branch June 12, 2017 14:42


		subsection:: What to prepare

		* have your system ready with all desired quarks installed,


		// 3. * time for the first wakeup kiss * //
		unixCmd("open" + ~pathToNewApp);


		Customize the "Standalone Resources" directory, which is located at the root of the SuperCollider source directory. Any files you put in this directory will override the files originating from the SuperCollider source at the same destination.
		// TO PREPARE, CHECK YOUR CURRENT config in Preferences->Interpreter:

An update to making macOS standalones. #2881

An update to making macOS standalones. #2881

Conversation

adcxyz commented May 21, 2017 • edited by LFSaw Loading

LFSaw left a comment

Choose a reason for hiding this comment

Choose a reason for hiding this comment

Choose a reason for hiding this comment

Choose a reason for hiding this comment

Choose a reason for hiding this comment

Choose a reason for hiding this comment

Choose a reason for hiding this comment

bagong commented May 27, 2017 • edited Loading

LFSaw commented May 27, 2017

adcxyz commented Jun 4, 2017

adcxyz commented Jun 4, 2017

mossheim commented Jun 5, 2017

LFSaw commented Jun 5, 2017

nhthn left a comment

Choose a reason for hiding this comment

Choose a reason for hiding this comment

Choose a reason for hiding this comment

Choose a reason for hiding this comment

Choose a reason for hiding this comment

Choose a reason for hiding this comment

Choose a reason for hiding this comment

nhthn Jun 5, 2017 • edited Loading

Choose a reason for hiding this comment

nhthn Jun 5, 2017 • edited Loading

Choose a reason for hiding this comment

Choose a reason for hiding this comment

nhthn Jun 5, 2017 • edited Loading

Choose a reason for hiding this comment

adcxyz commented Jun 6, 2017

nhthn left a comment

Choose a reason for hiding this comment

mossheim left a comment

Choose a reason for hiding this comment

Choose a reason for hiding this comment

Choose a reason for hiding this comment

Choose a reason for hiding this comment

Choose a reason for hiding this comment

mossheim commented Jun 8, 2017

adcxyz commented Jun 12, 2017

mossheim left a comment

Choose a reason for hiding this comment

telephon commented Jun 12, 2017

adcxyz commented Jun 13, 2017

adcxyz commented May 21, 2017 •

edited by LFSaw

Loading

bagong commented May 27, 2017 •

edited

Loading

nhthn Jun 5, 2017 •

edited

Loading

nhthn Jun 5, 2017 •

edited

Loading

nhthn Jun 5, 2017 •

edited

Loading