You are viewing a plain text version of this content. The canonical link for it is here.
Posted to commits@iotdb.apache.org by hx...@apache.org on 2019/07/17 13:10:04 UTC

[incubator-iotdb] branch doc_add_how_to_import_iotdb_to_ide created (now ee7390c)

This is an automated email from the ASF dual-hosted git repository.

hxd pushed a change to branch doc_add_how_to_import_iotdb_to_ide
in repository https://gitbox.apache.org/repos/asf/incubator-iotdb.git.


      at ee7390c  add documents to explain how to use IDEA/Eclipse to develop IoTDB

This branch includes the following new commits:

     new ee7390c  add documents to explain how to use IDEA/Eclipse to develop IoTDB

The 1 revisions listed above as "new" are entirely new to this
repository and will be described in separate emails.  The revisions
listed as "add" were already present in the repository and have only
been added to this reference.



[incubator-iotdb] 01/01: add documents to explain how to use IDEA/Eclipse to develop IoTDB

Posted by hx...@apache.org.
This is an automated email from the ASF dual-hosted git repository.

hxd pushed a commit to branch doc_add_how_to_import_iotdb_to_ide
in repository https://gitbox.apache.org/repos/asf/incubator-iotdb.git

commit ee7390ca11b8984c6b2604a7082b6c3b41c40200
Author: xiangdong huang <sa...@gmail.com>
AuthorDate: Wed Jul 17 21:09:26 2019 +0800

    add documents to explain how to use IDEA/Eclipse to develop IoTDB
---
 docs/Development.md | 39 +++++++++++++++++++++++++++++++++++++++
 1 file changed, 39 insertions(+)

diff --git a/docs/Development.md b/docs/Development.md
index 5b0edcc..6185425 100644
--- a/docs/Development.md
+++ b/docs/Development.md
@@ -23,6 +23,10 @@
 
 ## Outline
 
+- How to develop IoTDB in IDE
+    - IDEA
+    - Eclipse
+    - Debugging IoTDB
 - Have Questions
     - Mailing Lists
     - JIRA issues
@@ -42,6 +46,41 @@
             - Code Style
 
 <!-- /TOC -->
+# How to develop IoTDB in IDE
+
+There are many ways to compile the source code of IoTDB,
+e.g., modify and compile with IDEA or Eclipse.
+
+Once all UTs are passed after you modify codes, your modification basically works! 
+
+## IDEA
+
+Using IDEA to develop IoTDB is very simple: just click menu as follows: "File" -> 
+"Open" -> choose the pom.xml from the root path of IoTDB source code -> "Open as a project". 
+
+Everything is done.
+
+## Eclipse
+Using Eclipse to develop IoTDB is also simple but requires some plugins of Eclipse.
+
+- If your Eclipse version is released before 2019, Antlr plguin may be not work in Eclipse. In this 
+way, you have to run the command in your console first: `mvn eclipse:eclipse -DskipTests`. 
+After the command is done, you can import IoTDB as an existing project:
+  - Choose menu "import" -> "General" -> "Existing Projects into Workspace" -> Choose IoTDB
+   root path;
+  - Done.
+
+- If your Eclipse version is fashion enough (e.g., you are using the latest version of Eclipse),
+you can just choose menu "import" -> "Maven" -> "Existing Maven Projects".
+ 
+## Debugging IoTDB
+The main class of IoTDB server is `org.apache.iotdb.db.service.IoTDB`.
+The main class of IoTDB client is `org.apache.iotdb.cli.client.Client` 
+(or `org.apache.iotdb.cli.client.WinClient` on Win OS).
+
+You can run/debug IoTDB by using the two classes as the entrance.
+
+Another way to understand IoTDB is to read and try Unit Tests.
 
 # Have Questions