Notice: This Wiki is now read only and edits are no longer possible. Please see: https://gitlab.eclipse.org/eclipsefdn/helpdesk/-/wikis/Wiki-shutdown-plan for the plan.
Difference between revisions of "Spaces/Use Cases"
< Spaces
(New page: ===Use Case One=== # File > New > Project > Plug-in Development > Plug-in Project > "demo" ... Hello World ... # Right-click menu over project "demo" and choose Spaces > Publish... # A wiz...) |
|||
| Line 1: | Line 1: | ||
| − | ===Use Case One=== | + | ===Use Case One: Initial Publish=== |
# File > New > Project > Plug-in Development > Plug-in Project > "demo" ... Hello World ... | # File > New > Project > Plug-in Development > Plug-in Project > "demo" ... Hello World ... | ||
# Right-click menu over project "demo" and choose Spaces > Publish... | # Right-click menu over project "demo" and choose Spaces > Publish... | ||
| Line 17: | Line 17: | ||
## My friends and I can go to my AOL Eclipse Spaces update site using the Eclipse Update Manager (based on my AOL XDrive permissions) and download and install my "demo" plug-in. | ## My friends and I can go to my AOL Eclipse Spaces update site using the Eclipse Update Manager (based on my AOL XDrive permissions) and download and install my "demo" plug-in. | ||
| − | ===Use Case Two=== | + | ===Use Case Two: Incremental Publish=== |
# I modify the "demo" plug-in project to do something more interesting. | # I modify the "demo" plug-in project to do something more interesting. | ||
# Right-click menu on the "demo" project to do Spaces > Publish... | # Right-click menu on the "demo" project to do Spaces > Publish... | ||
| Line 24: | Line 24: | ||
# When the publish action is complete, the wizard shows me the public url to my update site. It is the same public url as it was for use case one. | # When the publish action is complete, the wizard shows me the public url to my update site. It is the same public url as it was for use case one. | ||
| − | ===Use Case Three=== | + | ===Use Case Three: Publish New Version=== |
# I modify the "demo" plug-in project yet again, this time to fix a bug. | # I modify the "demo" plug-in project yet again, this time to fix a bug. | ||
## I update the version number in the plugin.xml from 0.1 to 0.2 | ## I update the version number in the plugin.xml from 0.1 to 0.2 | ||
| Line 32: | Line 32: | ||
# When the publish action is complete, the wizard shows me the public url to my update site. It is the same public url as it was for use case one. | # When the publish action is complete, the wizard shows me the public url to my update site. It is the same public url as it was for use case one. | ||
| − | ===Use Case Four=== | + | ===Use Case Four: Publish a Second Plug-in=== |
# I use File > New > Project > Plug-in Project ... to make a new "coolness" plug-in. | # I use File > New > Project > Plug-in Project ... to make a new "coolness" plug-in. | ||
# Right-click menu on the "coolness" project to do Spaces > Publish... | # Right-click menu on the "coolness" project to do Spaces > Publish... | ||
| Line 41: | Line 41: | ||
# When the publish action is complete, the wizard shows me the public url to my update site. It is the same public url as it was for use case one. | # When the publish action is complete, the wizard shows me the public url to my update site. It is the same public url as it was for use case one. | ||
| − | ===Use Case Five=== | + | ===Use Case Five: Withdraw=== |
# I decide to withdraw the "coolness" plug-in at my AOL Eclipse Spaces. | # I decide to withdraw the "coolness" plug-in at my AOL Eclipse Spaces. | ||
# Right-click menu on the "coolness" project to do Spaces > Disconnect... | # Right-click menu on the "coolness" project to do Spaces > Disconnect... | ||
| Line 49: | Line 49: | ||
## Additionally, if I go to do a Spaces > Publish... on the "coolness" project in the future, I will be prompted again for which spaces provider to publish to. | ## Additionally, if I go to do a Spaces > Publish... on the "coolness" project in the future, I will be prompted again for which spaces provider to publish to. | ||
| − | ===Use Case Six=== | + | ===Use Case Six: Repair=== |
# I use the normal AOL Xdrive interface to manipulate the files on my Xdrive. I delete the older versions of the "demo" plug-in. | # I use the normal AOL Xdrive interface to manipulate the files on my Xdrive. I delete the older versions of the "demo" plug-in. | ||
## This messes up the update site, of course, but I can fix it by publishing again: | ## This messes up the update site, of course, but I can fix it by publishing again: | ||
| Line 58: | Line 58: | ||
# When the publish action is complete, the wizard shows me the public url to my update site. It is the same public url as it was for use case one. | # When the publish action is complete, the wizard shows me the public url to my update site. It is the same public url as it was for use case one. | ||
| − | ===Use Case Seven=== | + | ===Use Case Seven: Initial Share of Published Project=== |
# I decide to share the source code to the "demo" plug-in at my AOL Eclipse Spaces. | # I decide to share the source code to the "demo" plug-in at my AOL Eclipse Spaces. | ||
# Right-click menu on the "demo" project to do Spaces > Share... | # Right-click menu on the "demo" project to do Spaces > Share... | ||
| − | # | + | # Sets up a CVS or SVN (depends on the spaces provider) connection to my AOL Eclipse Spaces. |
| + | ## Sets the CVS/SVN module name to "demo". | ||
| + | # Switches me to the Team Synchronize perspective where I can complete the source code commit. | ||
| + | |||
| + | ===Use Case Eight: Describe URLs=== | ||
| + | # I want to share my source code with a colleague, but I don't remember how to connect to the repository. | ||
| + | # Right-click menu on the "demo" project to do Spaces > URLs... | ||
| + | # Opens a dialog box that displays the public urls/uris to all of the spaces bits about this project. The url to the update site that I have Spaces > Publish...ed; the url to the CVS/SVN repository that I have Spaces > Share...ed; etc. | ||
| + | |||
| + | ===Use Case Nine: Initial Share of New Project=== | ||
| + | # I use File > New > Project > Plug-in Project ... to make a new "nifty" plug-in. | ||
| + | # Right-click menu on the "nifty" project to do Spaces > Share... | ||
| + | # A wizard/dialog box opens to ask me a few questions including: | ||
| + | ## Which spaces adapter to use. I will choose "AOL Eclipse Spaces" for this example. | ||
| + | ## Because I've already logged-in to AOL Eclipse Spaces in this Eclipse instance, it proceeds to: | ||
| + | # Sets up a CVS or SVN (depends on the spaces provider) connection to my AOL Eclipse Spaces. | ||
| + | ## Sets the CVS/SVN module name to "nifty". | ||
| + | # Switches me to the Team Synchronize perspective where I can complete the source code commit. | ||
| + | |||
| + | ===Use Case Ten: Subsequent Share=== | ||
| + | # I modify the "nifty" project with some nifty new features. | ||
| + | # Right-click menu on the "nifty" project do do Spaces > Share... | ||
| + | # Because I've already set up the share of this project to my AOL Eclipse Spaces repository, it takes me directory to: | ||
| + | # Switches me to the Team Synchronize perspective where I can complete the source code commit. | ||
[[Category:Spaces]] | [[Category:Spaces]] | ||
Revision as of 23:23, 17 January 2008
Contents
- 1 Use Case One: Initial Publish
- 2 Use Case Two: Incremental Publish
- 3 Use Case Three: Publish New Version
- 4 Use Case Four: Publish a Second Plug-in
- 5 Use Case Five: Withdraw
- 6 Use Case Six: Repair
- 7 Use Case Seven: Initial Share of Published Project
- 8 Use Case Eight: Describe URLs
- 9 Use Case Nine: Initial Share of New Project
- 10 Use Case Ten: Subsequent Share
Use Case One: Initial Publish
- File > New > Project > Plug-in Development > Plug-in Project > "demo" ... Hello World ...
- Right-click menu over project "demo" and choose Spaces > Publish...
- A wizard/dialog box opens to ask me a few questions including:
- Which spaces adapter to use. I will choose "AOL Eclipse Spaces" for this example.
- Because this is the first time I have used AOL Eclipse Spaces in this instance of Eclipse, I am asked for my login and password. These are stored in the Eclipse workspace so that I don't have to enter them in the future.
- The Spaces plug-in does a client side build and then uploads the results to the storage server:
- Compile all the java code (usually already compiled via incremental compiler)
- Jar-up the class files.
- Jar into a plug-in jar with correct manifest file, etc.
- Create a feature.xml for this one plug-in. Saves the feature.xml along with the plugin.xml so that it can be re-used. (The Spaces plug-in either asks for the necessary information via the wizard, or it assumes some defaults, or it generates some defaults from the plug-in code.)
- Jar into a feature jar with correct manifest file, etc.
- Download the site.xml from my AOL Eclipse Spaces update site. If there is no site.xml, generate a new empty site.xml locally.
- Add this new feature to the local site.xml
- Upload the new site.xml, feature jar, and plugin jar to my AOL Eclipse Spaces update site.
- When the publish action is complete, the wizard shows me the public url to my update site.
- My friends and I can go to my AOL Eclipse Spaces update site using the Eclipse Update Manager (based on my AOL XDrive permissions) and download and install my "demo" plug-in.
Use Case Two: Incremental Publish
- I modify the "demo" plug-in project to do something more interesting.
- Right-click menu on the "demo" project to do Spaces > Publish...
- Because I've already published it to my AOL Eclipse Spaces and because I've already logged-in in this Eclipse instance, it just compiles, builds, and uploads the result.
- Because I did not change the version number in the plug-in, this new copy of the "demo" feature overwrites the existing feature on the update site.
- When the publish action is complete, the wizard shows me the public url to my update site. It is the same public url as it was for use case one.
Use Case Three: Publish New Version
- I modify the "demo" plug-in project yet again, this time to fix a bug.
- I update the version number in the plugin.xml from 0.1 to 0.2
- Right-click menu on the "demo" project to do Spaces > Publish...
- Because I've already published it to my AOL Eclipse Spaces and because I've already logged in in this Eclipse instances, it just compiles, builds, and uploads the result.
- Because I changed the version number in the plug-in, this new copy of the "demo" feature will be added to site.xml and now there will be two versions of the demo feature on my AOL Eclipse Spaces.
- When the publish action is complete, the wizard shows me the public url to my update site. It is the same public url as it was for use case one.
Use Case Four: Publish a Second Plug-in
- I use File > New > Project > Plug-in Project ... to make a new "coolness" plug-in.
- Right-click menu on the "coolness" project to do Spaces > Publish...
- A wizard/dialog box opens to ask me a few questions including:
- Which spaces adapter to use. I will choose "AOL Eclipse Spaces" for this example.
- Because I've already logged-in to AOL Eclipse Spaces in this Eclipse instance, it just compiles, builds, and uploads the result.
- Because this is a new plug-in/feature, this new "coolness" feature will added to site.xml and now there will be two versions of the "demo" feature (use cases 1 and 2) and one of the "coolness" feature on my AOL Eclipse Spaces.
- When the publish action is complete, the wizard shows me the public url to my update site. It is the same public url as it was for use case one.
Use Case Five: Withdraw
- I decide to withdraw the "coolness" plug-in at my AOL Eclipse Spaces.
- Right-click menu on the "coolness" project to do Spaces > Disconnect...
- A dialog asks me if I am sure
- Then it removes all instances of the "coolness" project from my AOL Eclipse Spaces update site.
- If I had done a Spaces > Share... or Spaces > Promote... or any of the other Spaces actions, the Spaces > Disconnect... would also clean up those actions.
- Additionally, if I go to do a Spaces > Publish... on the "coolness" project in the future, I will be prompted again for which spaces provider to publish to.
Use Case Six: Repair
- I use the normal AOL Xdrive interface to manipulate the files on my Xdrive. I delete the older versions of the "demo" plug-in.
- This messes up the update site, of course, but I can fix it by publishing again:
- Right-click menu on the "demo" project to do Spaces > Publish...
- Because I've already published it to my AOL Eclipse Spaces and because I've already logged-in in this Eclipse instance, it just compiles, builds, and uploads the result.
- Because I did not change the version number in the plug-in, this new copy of the "demo" feature overwrites the existing feature on the update site.
- Also the update site is rebuilt and the older versions of the "demo" feature are removed from the site.xml file.
- When the publish action is complete, the wizard shows me the public url to my update site. It is the same public url as it was for use case one.
- I decide to share the source code to the "demo" plug-in at my AOL Eclipse Spaces.
- Right-click menu on the "demo" project to do Spaces > Share...
- Sets up a CVS or SVN (depends on the spaces provider) connection to my AOL Eclipse Spaces.
- Sets the CVS/SVN module name to "demo".
- Switches me to the Team Synchronize perspective where I can complete the source code commit.
Use Case Eight: Describe URLs
- I want to share my source code with a colleague, but I don't remember how to connect to the repository.
- Right-click menu on the "demo" project to do Spaces > URLs...
- Opens a dialog box that displays the public urls/uris to all of the spaces bits about this project. The url to the update site that I have Spaces > Publish...ed; the url to the CVS/SVN repository that I have Spaces > Share...ed; etc.
- I use File > New > Project > Plug-in Project ... to make a new "nifty" plug-in.
- Right-click menu on the "nifty" project to do Spaces > Share...
- A wizard/dialog box opens to ask me a few questions including:
- Which spaces adapter to use. I will choose "AOL Eclipse Spaces" for this example.
- Because I've already logged-in to AOL Eclipse Spaces in this Eclipse instance, it proceeds to:
- Sets up a CVS or SVN (depends on the spaces provider) connection to my AOL Eclipse Spaces.
- Sets the CVS/SVN module name to "nifty".
- Switches me to the Team Synchronize perspective where I can complete the source code commit.
- I modify the "nifty" project with some nifty new features.
- Right-click menu on the "nifty" project do do Spaces > Share...
- Because I've already set up the share of this project to my AOL Eclipse Spaces repository, it takes me directory to:
- Switches me to the Team Synchronize perspective where I can complete the source code commit.