How to install ArcGIS plug-ins如何安装ArcGIS插件

ArcGIS SDK：file:///D:/ArcGIS/DeveloperKit10.2/java/tools/eclipse_plugin/readme.html

Summary摘要

ArcGIS Eclipse plug-in serves many functionalities that ease the development of ArcGIS Engine and Server Applications. This article guides the user step by step to install the plug-in as well as to update the plug-in periodically.

ArcGIS for Eclipse插件提供了许多功能，能够减轻ArcGIS Engine和Server应用开发的困难。本文章将指导用户一步一步安装插件，并定期更新插件。。

In this topic

About installing ArcGIS plug-ins关于安装ArcGIS插件
Downloading and installing Eclipse下载和安装Eclipse
- Increasing the memory heap size in Eclipse增加Eclipse的存储空间
Creating ArcGIS update sites创建ArcGIS更新站点
Installing ArcGIS plug-ins安装ArcGIS插件
Accessing ArcGIS Help Contents访问ArcGIS帮助文档
Updating ArcGIS plug-ins更新ArcGIS插件

About installing ArcGIS plug-ins

ArcGIS plug-ins for the Eclipse integrated development environment (IDE) have been created to ease ArcGIS Engine and ArcGIS Server application development. The ArcGIS plug-ins are 1.engine 2.server 3.doc.

为方便ArcGIS引擎和ArcGIS服务器应用程序开发，为Eclipse集成开发环境（IDE）创建了ArcGIS插件。ArcGIS插件为：1.engine 2.server 3.文档。

The engine plug-in is for developers who wish to build desktop applications using ArcGIS Engine. It provides templates to create simple visual applications, Geoprocessing code generator- a wizard to generate java wrappers for geoprocessing tools, the debugging tool for ArcObjects in Eclipse debug perspective and a list of Esri samples that demonstrates the various functionalities of the ArcGIS Engine product. 引擎插件是为希望使用ArcGIS Engine构建桌面应用程序的开发人员提供的。它提供了创建简单可视化应用程序的模板、地理处理代码生成器（为地理处理工具生成java包装器的向导）、Eclipse debug透视图中ArcObjects的调试工具以及演示ArcGIS引擎产品各种功能的Esri示例列表。
The server plug-in provides templates and samples relevant to ArcGIS server development. 服务器插件提供了与ArcGIS服务器开发相关的模板和示例。
The doc plug-in supplements the eclipse help content with the documentation for the ArcGIS Engine and ArcGIS Server application development as well as provides context help for ArcObjects during development. Packaging a comprehensive help system for ArcGIS Engine and ArcGIS Server SDK's can significantly increase memory size requirements and consequently, cause the installer to hang on some developer environments. Please refer to 'Accessing ArcGIS Help Content' for resolving issues with the Doc plug-in.doc插件用ArcGIS引擎和ArcGIS服务器应用程序开发的文档补充eclipse帮助内容，并在开发过程中为ArcObjects提供上下文帮助。为ArcGIS Engine和ArcGIS Server SDK打包一个全面的帮助系统可以显著增加内存大小需求，从而导致安装程序挂起在某些开发人员环境中。请参阅“访问ArcGIS帮助内容”以解决Doc插件的问题。

This article describes the necessary steps to download and configure eclipse and to install the engine and the doc plug-in.

The server plug-in requires ArcGIS server installation and engine plug-in requires ArcGIS Engine installation. It is recommended to uninstall any previous versions of ArcGIS plug-in before installation.

server插件需要安装ArcGIS Server，引擎插件需要安装ArcGIS Engine。建议在安装之前卸载任何早期版本的ArcGIS插件。

Downloading and installing Eclipse

ArcGIS Eclipse plug-ins are compatible with the Eclipse IDE for Java Developers built using Eclipse 3.3. You may download Eclipse IDE from Eclipse download site and install eclipse as suggested. For more information, refer Installing and using Eclipse IDE.

ArcGIS Eclipse插件与使用Eclipse3.3构建的面向Java开发人员的EclipseIDE兼容。您可以从Eclipse下载站点下载eclipseide，并按照建议安装Eclipse。有关更多信息，请参阅安装和使用eclipseide。

Increasing the memory heap size in Eclipse

Eclipse 3.3 allocates 512 megabytes (MB) of Java heap memory by default. However, to avoid out of memory errors during installation of ArcGIS plug-ins, it is strongly recommended to increase this amount to 1024 MB. It is also strongly recommended to add the Max Permgen size available to Eclipse and set it to 256M for server application development. To increase the heap memory:

Eclipse3.3默认分配512兆字节（MB）的Java堆内存。但是，为了避免在安装ArcGIS插件时出现内存不足错误，强烈建议将该值增加到1024MB。还强烈建议添加Eclipse可用的最大Permgen大小，并将其设置为256M以用于服务器应用程序开发。要增加堆内存：

Open the eclipse.ini file under the eclipse installation directory(eg. C:\eclipse) with a text editor.
By default, eclipse.ini contains something like:
         –showsplash
          org.eclipse.platform
          ––launcher.XXMaxPermSize
          256m
          –vmargs
          –Xms40m
          –Xmx256m

Which sets the heap space to 40MB initially and a maximum of 256MB, and also specifies a PermGen size of 256MB.
The suggested settings for ArcGIS application development are:
          –showsplash
          org.eclipse.platform
          –vmargs
          –Dosgi.requiredJavaVersion=1.5
          –Xms784m
          –Xmx1024m
          –XX:PermSize=256m
          –XX:MaxPermSize=256m
          –XX:+UseParallelGC
Save and close the eclipse.ini file.

Please refer to the following Eclipse WIKI sites for more information:

Creating ArcGIS update sites

The ArcGIS Eclipse plug-ins are installed by creating a local update site for the plug-ins.

ArcGIS Eclipse插件的安装是通过创建本地plugin站点。

On the Eclipse main menu select Help-> Software Updates-> Find and Install.
On the Install/Update dialog box select Search for new features to install and click Next. See the following screen shot:
You need to create a local update site to install ArcGIS Eclipse plug-ins. To create a new local update site, click 'New Local Site' button on the Install dialog box. See the following screen shot. Please note, that you may see different sites listed depending on the installed Eclipse version.

Browse to the location of the local site '%ARCGISHOME%/java/tools/eclipse_plugin/arcgis_update_site/engine and click OK. Change the name in the Edit Local Site dialog box to ArcGISEngineUpdateSite and click OK. See the following screen shot:

Also, Create another local update site as described above

(ArcGISDocUpdateSite) at location ARCGISHOME%/java/tools/eclipse_plugin/arcgis_update_site/doc for ArcGIS doc plug-in.

The ArcGISEngineUpdateSite and ArcGISDocUpdateSite appears in the list of sites to include in the search. Select the ArcGISEngineUpdateSite and ArcGISDocUpdateSite for and click Finish. See the following screen shot below:

You may also have to create ArcGISServerUpdateSite at location ARCGISHOME%/java/tools/eclipse_plugin/arcgis_update_site/doc for ArcGIS server plug-in for ArcGIS Server application development.

Installing ArcGIS Plug-ins

When a connection is made, the available features on the update sites are displayed. Click to expand the ArcGISDocUpdateSite and select all the ArcGIS Core and ArcGIS Doc check boxes. Similarly, click o expand the ArcGISEngineUpdateSite and select all of the check boxes. See the following screen shot:

The Visual Editor Project is required to install the ArcGIS Engine Palette flavor of the ArcGIS Eclipse plug-in. The ArcGIS Engine Palette flavor of the plug-in adds ArcGIS visual beans components to eclipse palette along with other swing components and hence, presents a convenient user interface to drag and drop ArcGIS visual bean components to design ArcGIS Engine Applications in Visual Editor mode. If the visual editor project is not installed in your eclipse installation, the ArcGIS Engine Palette flavor is non-functional.

If the Visual Editor Project is not available in Eclipse by default, you may manually install the Visual Editor project as a Eclipse plug-in before installing ArcGIS Engine Palette flavor. For more information, visit the Visual Editor Project website. However, If you would like to skip the ArcGIS Engine Palette feature, deselect the corresponding check box and click Finish.

The current version of Visual Editor(v1.2) requires Eclipse 3.2 (Callisto). The Web Tools Platform (WTP) all-in-one project (version 1.5.) that is bundled with Eclipse 3.2.2 provides Visual Editor update site to install Visual Editor plug-in by default.

Please read and accept Esri license agreement and click Next. See the following screen shot.

Select the preferred location to install the ArcGIS Eclipse Plug-in and Click Finish. See the following screen shot.

Click Install All on the verification dialog box and Restart Eclipse when prompted. See the following screen shot:

After restarting Eclipse, you may be prompted to set the ArcGIS installation directory. If so, browse and select the ArcGIS installation directory(%ARCGISHOME%). If you were not prompted, the ArcGIS Eclipse plug-in will automatically detect the installation directory. An Overview welcome page will be displayed. If not, click Help->Welcome. Click the Overview icon and in the subsequent page that is displayed, click on the Esri Globe icon. This subsequent page provides information for getting started with links t samples and the help system. See the following screen shot:

Accessing ArcGIS Help Content

Packaging a comprehensive help system for ArcGIS Engine and ArcGIS Server SDK's can significantly increase memory size requirements and cause some users environments to hang on install. The solution is to host the content as an InfoCenter site on a dedicated server, or locally on your development machine. Eclipse InfoCenters allow users to access help systems from remote servers over the internet or an intranet. The ArcGIS Java Developer Help System is available as a stand alone external system which can be started in 'Server' mode using the start/stop scripts available at '%ARCGISHOME%\java\ docs\' once the Help System has been installed.

On the Server where the ArcGIS Java Developer Help System is installed, navigate to '%ARCGISHOME%\java\docs\' and execute the'startJavaHelpServer.bat' script to start the server.

The ArcGIS Java Developer Help System InfoCenter uses port 2112 by default. You can access the Help System locally with the following url: http://localhost:2112/help/index.jsp. Replace 'localhost' with your server name or ip address to access the Help System remotely.

Once you have confirmed that your Help System is up and running, you can use the Remote Help System feature in Eclipse v3.3 to access the help system by merging your Eclipse local content with the ArcGIS remote content. The help system will behave as though it were local.

Open Eclipse on your developer machine and on the Eclipse main menu, select 'Window->Preferences�'.

In the Preference dialog, navigate to 'Help->Content'.

The Eclipse Help System needs to know the address (host/IP) and port of the remote server to integrate with the local system. Select the 'Include help content form a remote infocenter' checkbox and provide the following server information: (a)Host: Put a valid Server Name or IP Address where the remote infocenter is located. In our example the server name is 'javabuild'. (b) Path: '/help'. (c) Select the 'Use Port' radio box and put '2112' in the port text box. The dialog should resemble the image below with your server name replacing 'javabuild'.

Click 'OK' to close the Preference dialog.

Open up the Eclipse Help System, 'Help->Help Contents', to see the ArcGIS Java Developer Help System integrated into your local Eclipse Help System.

Updating ArcGIS plug-ins

Esri periodically releases updates for ArcGIS plug-ins that would include additional plug-in capabilities or new help documents and samples. Therefore it is recommended to verify if any updates are available periodically.

You may Update all sites including ArcGIS plug-in update site by selecting Help->Software Updates->Find and Install. In the subsequent dialog box, Select Search to find updates for the currently installed features, and click Finish. This option can be slow because it tries to update every installed feature.
To update only the ArcGIS plug-ins, select Help->Software Updates->Manage Configuration.

1. In the Product Configuration dialog box, click to expand the TOC.
2. Right-click the ArcGIS Core, ArcGIS Doc, or ArcGIS Engine node, then click Find Updates. See the following screen shot:

This article describes the installation of ArcGIS eclipse plug-ins and the steps to access the ArcGIS Help Contents within Eclipse Help and to update the ArcGIS plug-in sites periodically.