Skip to main content

Notice: this Wiki will be going read only early in 2024 and edits will no longer be possible. Please see: https://gitlab.eclipse.org/eclipsefdn/helpdesk/-/wikis/Wiki-shutdown-plan for the plan.

Jump to: navigation, search

Difference between revisions of "Platform-releng/Issues related to Mac App installations"

(Central place to document issues with "Mac App")
 
(added adopter section)
Line 1: Line 1:
= Eclipse SDK as a Mac App Installation =  
+
= Eclipse SDK as a Mac App -- Information for Users =  
  
 
This page is intended as a "transition" page as our Eclipse SDK is made into a more standard "Mac App", rather than having a non-standard (for Apple users) "directory layout". It will change over time as as issues are addressed, and hopefully become obsolete with the Mars release.  
 
This page is intended as a "transition" page as our Eclipse SDK is made into a more standard "Mac App", rather than having a non-standard (for Apple users) "directory layout". It will change over time as as issues are addressed, and hopefully become obsolete with the Mars release.  
Line 27: Line 27:
  
 
  [TBD] ~/Library/Application Support/? ... ~/.eclipse/?
 
  [TBD] ~/Library/Application Support/? ... ~/.eclipse/?
 +
 +
= Eclipse SDK as a Mac App -- Information for Adopters =
 +
 +
== Tycho Builds ==
 +
 +
Some of he changes to produce this "Mac App" layout is in the p2 publisher. Some is in the Tycho Builder. At the time of this writing, Tycho 0.23.0-SNAPSHOT must be used to publish "Products" with the Mac App layout. At the moment this is the only layout possible, and the older "directory layout" is not possible. (Watch {{bug|461606}}.) To get the correct layout, though, a slight change to "product" pom files is required -- you will need a "rootFolders" element. Where previously you may have had
 +
<pre><nowiki>
 +
 +
            <id>materialize-products</id>
 +
            <goals>
 +
              <goal>materialize-products</goal>
 +
            </goals>
 +
            <configuration>
 +
              <profile>SDKProfile</profile>
 +
              <products>
 +
                <product>
 +
                  <id>org.eclipse.platform.ide</id>
 +
                  <rootFolder>eclipse</rootFolder>
 +
                </product>
 +
              </products>
 +
            </configuration>
 +
</nowiki></pre>
 +
You will now need
 +
<pre><nowiki>
 +
            <id>materialize-products</id>
 +
            <goals>
 +
              <goal>materialize-products</goal>
 +
            </goals>
 +
            <configuration>
 +
              <profile>SDKProfile</profile>
 +
              <products>
 +
                <product>
 +
                  <id>org.eclipse.platform.ide</id>
 +
                  <rootFolder>eclipse</rootFolder>
 +
                  <rootFolders>
 +
                    <macosx>Eclipse.app</macosx>
 +
                  </rootFolders>
 +
                </product>
 +
              </products>
 +
            </configuration>
 +
</nowiki></pre>

Revision as of 14:58, 20 March 2015

Eclipse SDK as a Mac App -- Information for Users

This page is intended as a "transition" page as our Eclipse SDK is made into a more standard "Mac App", rather than having a non-standard (for Apple users) "directory layout". It will change over time as as issues are addressed, and hopefully become obsolete with the Mars release.

Mars M6 Update Warning

For Mars M6, you can not "update" from an existing "directory layout" installation. You must download a fresh version, and start with that. In fact, for M6, there is nothing to prevent the update from being attempted, but will leave you with a broken installation. (Watch bug 462282.) In fact, even with the final Mars release, you will not be able to "update", but the plan is to prevent it from happening, and give a proper instructions to users if they try.

Recovering from a broken installation

In the event you did try to update, before the protections are put in place, this is the procedure to "recover" your previous installation with minimal effort. (Thanks to Markus Keller, who provided this outline, in bug 462282#13.)

  • Get a fresh download of M6 (or later) of the App you intend to use, such as from

Eclipse Project Downloads to create a fresh installation.

  • From the downloaded tar file, extract the Eclipse.app to the location where you would like it to be.
  • Launch the fresh Eclipse.app
  • Choose File > Import... > Install > From Existing Installation
  • Click Browse... and open the folder that contains your (broken) Eclipse.app
  • Click Select All, Next, and Finish the import
  • After a restart, all your plug-ins are available and work as before.

Eclipse Apps are similar to "shared installs"

One change, from previous "directory layout" is that the "Eclipse App" will behave similar to what is called a "shared install". This is primarily due to the way Apple apps are "signed" where is is expected that nothing "under" Eclipse.app will be changed (or, if it is it will "break" the signature).

This means that as you install new plugins, or make customizations, they are not saved "under" Eclipse.app, but are saved under

[TBD] ~/Library/Application Support/? ... ~/.eclipse/?

Eclipse SDK as a Mac App -- Information for Adopters

Tycho Builds

Some of he changes to produce this "Mac App" layout is in the p2 publisher. Some is in the Tycho Builder. At the time of this writing, Tycho 0.23.0-SNAPSHOT must be used to publish "Products" with the Mac App layout. At the moment this is the only layout possible, and the older "directory layout" is not possible. (Watch bug 461606.) To get the correct layout, though, a slight change to "product" pom files is required -- you will need a "rootFolders" element. Where previously you may have had


            <id>materialize-products</id>
            <goals>
              <goal>materialize-products</goal>
            </goals>
            <configuration>
              <profile>SDKProfile</profile>
              <products>
                <product>
                  <id>org.eclipse.platform.ide</id>
                  <rootFolder>eclipse</rootFolder>
                </product>
              </products>
            </configuration>

You will now need

            <id>materialize-products</id>
            <goals>
              <goal>materialize-products</goal>
            </goals>
            <configuration>
              <profile>SDKProfile</profile>
              <products>
                <product>
                  <id>org.eclipse.platform.ide</id>
                  <rootFolder>eclipse</rootFolder>
                   <rootFolders>
                     <macosx>Eclipse.app</macosx>
                   </rootFolders>
                </product>
              </products>
            </configuration>

Back to the top