Working With Cloned Module

From Foss2Serve
(Difference between revisions)
Jump to: navigation, search
(changed to mentors... was formerly hard to understand if read by someone not knowing that someone else might be involved)
 
(14 intermediate revisions by 6 users not shown)
Line 1: Line 1:
 
__NOTOC__
 
__NOTOC__
{| border="1"
 
|-
 
|'''Title''' || Name of the activity
 
|-
 
|'''Overview''' || High level description of what the student will do
 
|-
 
|'''Prerequisite Knowledge''' || What topics and tools does the student need to know prior to beginning this activity?
 
|-
 
|'''Learning Objectives''' || What should the student be able to do after completing completed this activity?
 
|}
 
  
=== Background: ===
+
{{Learning Activity Overview
Is there background reading material?
+
|title=
 +
Work with a Cloned Module (Build and Execute gnome-photos module)
 +
|overview=  
 +
Building is the process of converting the source code into an executable by compiling and linking. In this document, we will build and execute an open source module cloned using git.
 +
|prerequisites=
 +
[[Build a GnomeMusic Clone (Activity)]]
 +
|objectives=
 +
* Build a previously cloned module.
 +
* Execute the cloned module.
 +
|process skills=
 +
}}
  
Are there other activities the student should have done first?
 
  
What is the rational for this activity?
+
=== Background ===
  
Include helpful hints to faculty here.
+
For this lab, we will be using previously cloned module gnome-photos to demonstrate building and executing.
  
=== Directions: ===
+
=== Directions ===
What should the student do?
+
'''1. Before Starting:'''
  
=== Deliverables: ===
+
Before running any of the command below, make sure that you are a sudo user. If not type the command $ su and then enter the root password when prompted.
What will the student hand in?
+
Also, make sure you are in the cloned directory using cd command.
  
=== Assessment: ===
+
'''2. Start the Build:''' Type the following command in the terminal to start building:
How will the activity be graded?
+
  dnf builddep gnome-photos
+
How will learning will be measured?
+
  
Include sample assessment questions/rubrics.
+
Note: To build a module, make sure that you have all the build dependencies available. Some modules depend on external libraries.
  
{| border="1"
+
Accept the dependency downloads whenever prompted. Wait till the process completes.
|-
+
|'''Criteria''' ||'''Level 1 (fail)'''||'''Level 2 (pass)'''||'''Level 3 (good)'''||'''Level 4 (exceptional)'''
+
|-
+
|Proper Pull Request ||  ||  ||  || 
+
|-
+
|Commit comment ||  ||  ||  || 
+
|-
+
|Edited file ||  ||  || || 
+
|-
+
|}
+
  
=== Comments: ===
+
'''3. Finish the Build:'''
What should the instructor know before using this activity?
+
  
What are some likely difficulties that an instructor may encounter using this activity?
+
Once the process completes, create a new directory under /opt directory as /opt/gnome-photos
  
=== Additional Information: ===
+
mkdir /opt/gnome-photos
{| border="1"
+
|-
+
|'''Knowledge Area/Knowledge Unit''' || What ACM Computing Curricula 2013 knowledge area and units does this activity cover? [[ACM_Body_of_Knowledge]]
+
|-
+
|'''Topic''' || What specific topics are addressed? The Computing Curriucula 2013 provides a list of topics - https://www.acm.org/education/CS2013-final-report.pdf
+
|-
+
|'''Level of Difficulty''' || Is this activity easy, medium or challenging?
+
|-
+
|'''Estimated Time to Completion''' ||  How long should it take for the student to complete the activity?
+
|-
+
|'''Materials/Environment''' || What does the student need?  Internet access, IRC client, Git Hub account, LINUX machine, etc.?
+
|-
+
|'''Author''' || Who wrote this activity?
+
|-
+
|'''Source''' || Is there another activity on which this activity is based?  If so, please provide a link to the original resource.
+
|-
+
|'''License''' || Under which license is this material made available? (http://creativecommons.org/licenses/)
+
|}
+
  
 +
Now execute the autogen.sh file under the cloned directory to build the module to newly created directory.
  
=== Suggestions to Open Source Mentors: ===
+
./autogen.sh – -prefix =/opt/gnome-photos
Suggestions for an open source community member who is working in conjunction with the instructor.
+
  
 +
'''4. Install the Module:'''
  
--------------------
+
Once completed, just install the program using make command as shown below:
This work is licensed under a  
+
  make install
[http://creativecommons.org/licenses/by-sa/4.0/ Creative Commons Attribution-ShareAlike 4.0 International License]
+
 
 +
 
 +
''5. Documentation:'''
 +
 
 +
Create a file in your favorite editor. Add all your screenshots and then answer the following questions in the next section in your file.
 +
Also, review the following rubric for generating and submitting your work.  Once you are satisfied that your lab is complete, create a pdf file and name it FossGnomePhotoCloned_yourlastnamefirstinitial.pdf. Upload to your course management system.
 +
 
 +
=== Deliverables ===
 +
 
 +
Create a word document and include screenshots of different stages of installations in it. In addition, answer the questions.
 +
 
 +
 
 +
'''Lab Rubric (100 points)'''
 +
 
 +
Screenshots (50 points) Start the Build (10 points); Accept (10 points); Finish the Build (10 points); Create Directory and autogen (10 points); Install Module (10 points)
 +
 
 +
Lab Questions (50 points)
 +
 
 +
• Compare dnf and yum with each other. Discuss on the similarities as well as differences. (10 points)
 +
• What is dnf builddep Plugin? (10 points) )
 +
• What does the autogen.sh do? (10 points)
 +
• Name two disadvantages of using a virtual machine. (10 points)
 +
• Grammar, Spelling and Neatness (5 points) – named file correctly and uploaded properly on time. (5 points)
 +
 
 +
 
 +
=== Additional Information: ===
  
[[File:CC_license.png]]
+
{{Learning Activity Info
 +
|acm unit=
 +
SE - Software Engineering
 +
|acm topic=
 +
Cloning, Build/Execute
 +
|difficulty=
 +
easy
 +
|time=
 +
60 minutes
 +
|environment=
 +
Fedora, gnome-photos
 +
|author=
 +
Mohsen Dorodchi
 +
|source=
 +
|license=
 +
{{License CC BY SA}}
 +
}}
  
[[Category: Learning_Activity]]
+
[[Category:Learning Activity]]
[[Category: LEARNING_ACTIVITY_SUBCATEGORY]]
+
[[Category:Minimal Sketch]]

Latest revision as of 12:54, 8 September 2018


Title

Work with a Cloned Module (Build and Execute gnome-photos module)

Overview

Building is the process of converting the source code into an executable by compiling and linking. In this document, we will build and execute an open source module cloned using git.

Prerequisites

Build a GnomeMusic Clone (Activity)

Learning
Objectives
After successfully completing this activity, the learner should be able to:
  • Build a previously cloned module.
  • Execute the cloned module.
Process Skills
Practiced


Background

For this lab, we will be using previously cloned module gnome-photos to demonstrate building and executing.

Directions

1. Before Starting:

Before running any of the command below, make sure that you are a sudo user. If not type the command $ su and then enter the root password when prompted. Also, make sure you are in the cloned directory using cd command.

2. Start the Build: Type the following command in the terminal to start building:

 dnf builddep gnome-photos

Note: To build a module, make sure that you have all the build dependencies available. Some modules depend on external libraries.

Accept the dependency downloads whenever prompted. Wait till the process completes.

3. Finish the Build:

Once the process completes, create a new directory under /opt directory as /opt/gnome-photos

mkdir /opt/gnome-photos

Now execute the autogen.sh file under the cloned directory to build the module to newly created directory.

./autogen.sh – -prefix =/opt/gnome-photos

4. Install the Module:

Once completed, just install the program using make command as shown below:

 make install


5. Documentation:'

Create a file in your favorite editor. Add all your screenshots and then answer the following questions in the next section in your file. Also, review the following rubric for generating and submitting your work. Once you are satisfied that your lab is complete, create a pdf file and name it FossGnomePhotoCloned_yourlastnamefirstinitial.pdf. Upload to your course management system.

Deliverables

Create a word document and include screenshots of different stages of installations in it. In addition, answer the questions.


Lab Rubric (100 points)

Screenshots (50 points) Start the Build (10 points); Accept (10 points); Finish the Build (10 points); Create Directory and autogen (10 points); Install Module (10 points)

Lab Questions (50 points)

•	Compare dnf and yum with each other. Discuss on the similarities as well as differences. (10 points)
•	What is dnf builddep Plugin? (10 points) ) 
•	What does the autogen.sh do? (10 points) 
•	Name two disadvantages of using a virtual machine. (10 points)
•	Grammar, Spelling and Neatness (5 points) – named file correctly and uploaded properly on time. (5 points)


Additional Information:

ACM BoK
Area & Unit(s)

SE - Software Engineering

ACM BoK
Topic(s)

Cloning, Build/Execute

Difficulty

easy

Estimated Time
to Complete

60 minutes

Environment /
Materials

Fedora, gnome-photos

Author(s)

Mohsen Dorodchi

Source
License

This work is licensed under a Creative Commons Attribution-ShareAlike 4.0 International License

CC license.png

Personal tools
Namespaces
Variants
Actions
Events
Learning Resources
HFOSS Projects
Evaluation
Navigation
Toolbox