dmg coming, link to discussion
[wiki.git] / inkscape / mac.mdwn
1 Inkscape will be officially supported on Mac with the release of version 1.0, which is currently under development.
2
3 Alpha releases of Inkscape 1.0 are available that more or less "just work" on Mac. Bugs should be expected because alpha releases are even less stable than beta releases.
4
5 ## Installing Inkscape 1.0alpha2 on Mac
6
7 Inkscape 1.0alpha2 is the first release to offer a download for Mac.
8
9 ### Downloading Inkscape.app.tar.gz
10
11 Update: According to the [discussion][] in the "team_devel_mac" channel on 2019-08-17, a dmg file may be available soon.
12
13 [discussion]: https://chat.inkscape.org/channel/team_devel_mac?msg=ZnBKxDk98Fnizrfq5
14
15 https://inkscape.org/release/inkscape-1.0alpha2/ is the place to start. Click "Mac OS" and the file "Inkscape.app.tar.gz" should be automatically saved to your "Downloads" folder.
16
17 ### Expanding Inkscape.app.tar.gz
18
19 "tar.gz" indicates that you have downloaded a "tarball", which is very similar to a zip file. You will need to "expand" this tarball before you have an "Inkscape" file that you can drag into your "Applications" folder.
20
21 Unfortunately, if you simply double-click "Inkscape.app.tar.gz" in your "Downloads" folder, you will get the following error:
22
23 > Unable to expand "Inkscape.app.tar.gz" into "Downloads".  
24 > (Error 1 - Operation not permitted)
25
26 A workaround for expanding the tarball is to open the "Terminal" application and type the following commands:
27
28     cd Downloads
29     tar xfz Inkscape.app.tar.gz
30
31 You will see some errors about "Python.framework" that you can safely ignore. (See below under "known issues" for more details on these errors.)
32
33 You should now have a file called "Inkscape" that looks like the Inkscape logo in your "Downloads" folder.
34
35 ### Putting Inkscape in your Applications Folder
36
37 Drag "Inkscape" from "Downloads" to "Applications".
38
39 ### Launching Inkscape for the first time
40
41 Depending on your security settings, you may see an error like the following when you double-click "Inkscape" to launch it:
42
43 > "Inkscape" can't be opened because it is from an unidentified developer.  
44 > Your security preferences allow installation of only apps from the App Store and identified developers.
45
46 The workaround is go to open "System Preferences" and then click "Security & Privacy" and then click "Open Anyway" next to the message that says the following:
47
48 > "Inkscape" was blocked from opening because it is not from an identified developer.
49
50 Once you have clicked "Open Anyway" you should see a dialog that say the following:
51
52 > "Inkscape is from an unidentified developer. Are you sure you want to open it?  
53 > Opening "Inkscape" will always allow it to run on this Mac.
54
55 Click "Open" and Inkscape should open.
56
57 ## Known issues with Inkscape 1.0alpha2 on Mac
58
59 ### Python.framework errors when expanding tarball
60
61 When you use the `tar xfz Inkscape.app.tar.gz` workaround above, the following errors will be shown:
62
63     Inkscape.app/Contents/Frameworks/Python.framework/Versions/Current/Headers: Can't remove already-existing dir
64     Inkscape.app/Contents/Frameworks/Python.framework/Versions/3.6/Headers: Can't remove already-existing dir
65     Inkscape.app/Contents/Frameworks/Python.framework/Versions/Current: Can't remove already-existing dir
66     Inkscape.app/Contents/Frameworks/Python.framework/Headers: Can't remove already-existing dir
67     Inkscape.app/Contents/Frameworks/Python.framework/Resources: Can't remove already-existing dir
68     tar: Error exit delayed from previous errors.
69
70 It is unknown if these errors relate to any bugs in Inkscape 1.0alpha2.