Muchos estudiantes que quieren participar en el desarrollo de un proyecto no saben qué tareas son adecuadas para ellos porque no hay nadie que les dirija el camino y tampoco saben cómo participar en el proyecto. Hoy les presentaré cómo participar en el desarrollo. El objetivo principal de este artículo es ayudarlo a unirse a la comunidad.
El texto tiene 1512 palabras y el tiempo de lectura estimado es de 4 minutos.
El contenido de hoy incluye principalmente: suscribirse a la lista de correo, encontrar problemas, compilar el código fuente y depurar el código del servidor.
Suscríbete a la lista de correo
El principal método de comunicación del proyecto Apache es la lista de correo. La lista de correo de los desarrolladores de nuestro proyecto es [email protected]. Siempre que se suscriba a esta lista de correo, puede recibir correos electrónicos de otras personas en este buzón. Otros recibirán correos electrónicos enviados aquí, similar a un grupo de WeChat con un retraso ligeramente mayor.
El método de suscripción es enviar un correo electrónico a [email protected] con cualquier contenido temático, puede escribir subscribe. A continuación, recibirá un correo electrónico de confirmación con un enlace en el correo electrónico de confirmación. Si responde a este enlace de confirmación, la suscripción es exitosa.
Lo primero que debe hacer después de suscribirse es publicar una autopresentación. Puede presentar su nombre, región, empresa, idioma familiar, pila de tecnología, etc.
No es necesario que se tome la lista de correo como un lugar serio. De hecho, puede discutir cualquier tema relacionado con el proyecto aquí, incluida la celebración de una reunión, informar errores, compartir ideas de diseño o simplemente comenzar y esperar que otros presenten algunas tareas introductorias. de.
La actitud cuando llegué por primera vez a la lista de correo es: no tener miedo de cometer errores, no tener miedo de cometer errores, hablar con entusiasmo.
Encuentra el problema correcto
Yo suelo usar jira.
https://issues.apache.org/jira/projects/IOTDB/issues
Además, también está disponible la edición de github.
Si no sabe qué funciones son adecuadas para usted, puede preguntar en la lista de correo o preguntarme a mí.
Compila el código fuente
git clone https://github.com/apache/incubator-iotdb.git
cd incubator-iotdb
mvn clean package -DskipTests
A continuación, debe marcar los directorios thrift / target / generate-sources / thrift y antlr / target / generate-sources / antlr4 como código fuente del proyecto para que el IDE lo reconozca.
Tome IDEA marcando el directorio antlr como ejemplo:
Hasta ahora, no debería haber rojo en el código.
Código del servidor de depuración
Para depurar IoTDB por primera vez, puede comenzar con dos módulos, el servidor (servidor) y la herramienta de línea de comandos (cli).
Primero inicie el servidor, la clase principal IoTDB, e inicie el modo de depuración.
A continuación, establezca un punto de interrupción en el executeStatement de la clase TSServiceImpl. Todas las declaraciones escritas en Cli se enviarán al servidor, y el hilo del servidor procesará la declaración a través de esta función rpc.
A continuación, inicie la herramienta de línea de comandos. La clase principal es Cli (mac, linux) o WinCli (windows). Informará los parámetros que faltan después del inicio. En este momento, puede seleccionar Cli en la flecha y luego Editar configuración
Establezca varios parámetros en la clase javadoc en Argumentos del programa, haga clic en Aplicar, Aceptar.
Luego puede ejecutar para iniciar Cli (si desea depurar el cliente, puede iniciarlo en modo de depuración). Después del inicio, puede ingresar un comando en la consola de ejecución. Aquí, tomamos la creación de un grupo de almacenamiento como ejemplo. Después de ingresar y presionar Enter, el proceso del cliente comienza a esperar a que el servidor devuelva resultados.
En este momento, saltará automáticamente al depurador del proceso del servidor y podrá depurar oficialmente.
Otro adecuado para aprender código es ejecutar casos de prueba.Cada módulo tiene un caso de prueba correspondiente.El nombre de UT común corresponde a (nombre de clase probado + Prueba), y el sufijo de prueba de integración es IT.
para resumir
Después de dar el primer paso, puede comparar el código con el documento de diseño, http://iotdb.apache.org/zh/SystemDesign/Architecture/Architecture.html. A continuación, presentaré los principios de diseño y el análisis del código fuente de IoTDB. ¡Bienvenido a seguir!