7502e4f03d8a8e6ace06fbfd8799893367ffa8d7
[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 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.
12
13 ### Expanding Inkscape.app.tar.gz
14
15 "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.
16
17 Unfortunately, if you simply double-click "Inkscape.app.tar.gz" in your "Downloads" folder, you will get the following error:
18
19 > Unable to expand "Inkscape.app.tar.gz" into "Downloads".  
20 > (Error 1 - Operation not permitted)
21
22 A workaround for expanding the tarball is to open the "Terminal" application and type the following commands:
23
24     cd Downloads
25     tar xfz Inkscape.app.tar.gz
26
27 You will see some errors about "Python.framework" that you can safely ignore. (See below under "known issues" for more details on these errors.)
28
29 You should now have a file called "Inkscape" that looks like the Inkscape logo in your "Downloads" folder.
30
31 ### Putting Inkscape in your Applications Folder
32
33 Drag "Inkscape" from "Downloads" to "Applications".
34
35 ### Launching Inkscape for the first time
36
37 Depending on your security settings, you may see an error like the following when you double-click "Inkscape" to launch it:
38
39 > "Inkscape" can't be opened because it is from an unidentified developer.  
40 > Your security preferences allow installation of only apps from the App Store and identified developers.
41
42 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:
43
44 > "Inkscape" was blocked from opening because it is not from an identified developer.
45
46 Once you have clicked "Open Anyway" you should see a dialog that say the following:
47
48 > "Inkscape is from an unidentified developer. Are you sure you want to open it?  
49 > Opening "Inkscape" will always allow it to run on this Mac.
50
51 Click "Open" and Inkscape should open.
52
53 ## Known issues with Inkscape 1.0alpha2 on Mac
54
55 ### Python.framework errors when expanding tarball
56
57 When you use the `tar xfz Inkscape.app.tar.gz` workaround above, the following errors will be shown:
58
59     Inkscape.app/Contents/Frameworks/Python.framework/Versions/Current/Headers: Can't remove already-existing dir
60     Inkscape.app/Contents/Frameworks/Python.framework/Versions/3.6/Headers: Can't remove already-existing dir
61     Inkscape.app/Contents/Frameworks/Python.framework/Versions/Current: Can't remove already-existing dir
62     Inkscape.app/Contents/Frameworks/Python.framework/Headers: Can't remove already-existing dir
63     Inkscape.app/Contents/Frameworks/Python.framework/Resources: Can't remove already-existing dir
64     tar: Error exit delayed from previous errors.
65
66 It is unknown if these errors relate to any bugs in Inkscape 1.0alpha2.