Building Oracle ADF Applications with Ant Using Oracle Developer Cloud Service

1. Open JDeveloper.

2. From the Team menu, click Team Server, and then click Add Team Server.

   View Image

   

3. In the New Team Server dialog, enter the following information:

• Name: Enter Developer Cloud Team Server

• URL: Enter the URL of your organization on the Oracle Developer Cloud Service instance

  Example: https://developer.us2.oraclecloud.com/my-org/

  View Image

  

  Oracle Developer Cloud Service is the default provider of the Team Server. If necessary, click Proxy Configuration to configure the proxy settings.

4. Click OK.

   The Team tab is now available in JDeveloper.

   View Image

   

5. In the Team tab, click Click here to select project.

   View Image

   

6. In the Developer Cloud Team Server list, click Login.

   View Image

   

7. In the Login to Team Server dialog, enter the following information:

   • Username: Enter your Oracle Developer Cloud Service instance user name

   • Password: Enter your Oracle Developer Cloud Service instance password

   View Image

   

8. Click Login.

   After a successful login, the Team Server displays all projects that you own or are a member of.

   View Image

   

1. In the Developer Cloud Team Server project list, click ADF Sample Application.

   View Image

   

2. Expand Sources and click the get link of the adf-sample-application.git repository.

   View Image

   

3. In the Get Sources from Oracle Developer Cloud Service dialog, click Get from Developer Server.

   View Image

   

4. In the Welcome page of the Clone from Git wizard, click Next.

   View Image

   

5. In the Remote Repository page, click Next.

   View Image

   

   The wizard picks the values for Repository URL, Username, and Password from the Team Server. If you prefer to use SSH, update the values of Repository URL and Private Key File before clicking Next.

6. In the Remote Branch page, click Next.

   View Image

   

   The page is empty because the Git repository being cloned is empty.

7. In the Destination page, if necessary, update the following information:

   • Destination: The path of the directory where you want to clone the Git repository

   • Clone Name: The name of the cloned Git repository directory

   The Checkout Branch drop-down list is expected to be empty.

   View Image

   

8. Click Next.

9. In the Git Clone Summary page, click Finish.

   View Image

   

10. In the New Gallery dialog, click Cancel to close the dialog.

    View Image

    

    You will not create an application, but add the Oracle Alta UI Work Better Application to the cloned Git repository directory.

1. In the cloned repository directory, extract the contents of the Oracle Alta UI Work Better Application zip file (WorkBetterFaces1221.zip).

   View Image

   

2. In JDeveloper, open the WorkBetterFaces application.

   View Image

   

3. From the Team menu, select Git, and then select Add All.

   View Image

   

4. In the Add All dialog, click OK.

   View Image

   

   After all files are added to the staging index, notice the icons in the Applications window have changed to show a + icon in the lower left corner.

   View Image

   

5. From the Team menu, select Git, and then select Commit All.

   View Image

   

6. In the Commit All dialog, enter a comment in Comments.

   If necessary, specify your name and email address in the Author and Commiter fields in the Name <email> format.

   View Image

   

7. Click OK.

   Notice the icons in the Applications window have changed to show a yellow circle in the lower-left corner.

   View Image

   

8. From the Team menu, select Git, and then select Push.

   View Image

   

9. In the Welcome page of the Push to Git wizard, click Next.

   View Image

   

10. In the Remote Repository page, click Next.

    View Image

    

    The wizard picks the values for Repository URL, Username, and Password from the Team Server. If you prefer to use SSH, update the values of Repository URL and Private Key File before clicking Next.

11. In the Local Branch page, click Next.

    View Image

    

    The master branch was created when you committed the application files.

12. In the Commits page, click Next.

    View Image

    

13. In the Git Push Summary page, click Finish.

    View Image

    

    A Git Push progress bar appears in the Status bar of JDeveloper. Wait for JDeveloper to push all files to the project Git repository.

    View Image

    

    After the Git Push is complete, open the project in Oracle Developer Cloud Service web interface and verify the commit in the Project page.

    View Image

    

1. In JDeveloper, open the WorkBetterFaces application, if you closed it.

2. From the File menu, click New, and then click From Gallery.

   View Image

   

3. In the New Gallery dialog, select Ant in the General Category, and then select Buildfile from Application in the Items list.

   View Image

   

4. Click OK.

5. In the Create Buildfile from Application dialog, select the Include Packaging Tasks (uses ojdeploy) check box and click OK.

   View Image

   

   Two new files, build.xml and build.properties, are added to the ADF application.

   View Image

   

1. Double-click build.xml to open it in the code editor.

   View Image

   

2. Add the following code line before <property file="build.properties"/>:

   <property environment="env"/>

   The <property environment="env"/> code in build.xml enables Ant to access the system environment variables and store them in properties, prefixed with env.

   View Image

   

3. Save build.xml.

4. Double-click build.properties to open it in the code editor.

   View Image

   

5. Remove the existing code of build.properties and add the following code to it.

   View Code
   oracle.commons=../../../../oracle_common/
   install.dir=../../../..
   oracle.home=${env.ORACLE_HOME_SOA_12_2_1}
   oracle.jdeveloper.workspace.path=${env.WORKSPACE}/WorkBetterFaces/WorkBetterFaces.jws
   middleware.home=${env.MIDDLEWARE_HOME_SOA_12_2_1}
   workspace=${env.WORKSPACE}
   oracle.jdeveloper.ant.library=${env.ORACLE_HOME_SOA_12_2_1}/jdev/lib/ant-jdeveloper.jar
   oracle.jdeveloper.deploy.dir=${env.WORKSPACE}/ViewController/deploy
   oracle.jdeveloper.ojdeploy.path=${oracle.home}/jdev/bin/ojdeploy
   javac.nowarn=off
   oracle.jdeveloper.project.name=ViewController
   oracle.jdeveloper.deploy.outputfile=${env.WORKSPACE}/WorkBetterFaces/ViewController/deploy/${profile.name}
   output.dir=classes
   javac.deprecation=off
   oracle.jdeveloper.deploy.profile.name=*
   javac.debug=on

   In the above code, you are configuring Ant to use the Oracle Developer Cloud Service environment variables.

   • oracle.home uses the ORACLE_HOME_SOA_12_2_1 environment variable to define the path of the JDeveloper 12.2.1 directory installed on the Oracle Developer Cloud Service Hudson executor.

   • middleware.home uses the MIDDLEWARE_HOME_SOA_12_2_1 environment variable to define the path of the Oracle Fusion Middleware directory installed on the Oracle Developer Cloud Service Hudson executor.

   • oracle.jdeveloper.ant.library defines the path of the Ant library on the Oracle Developer Cloud Service Hudson executor

   • oracle.jdeveloper.ojdeploy.path defines the path of OJDeploy on the Oracle Developer Cloud Service Hudson executor

   • oracle.jdeveloper.deploy.outputfile defines the path of the output file

   • oracle.jdeveloper.deploy.dir defines the path of the deployed artifacts directory

   To learn more about Oracle Developer Cloud Service environment variables on the Hudson executor, see the Using Hudson Environment Variables reference in the Want to Learn More section.

   View Image

   

   Make sure there are no spaces at the end of each property definition.

6. Save the build.properties file.

1. From the Team menu, select Git, and then select Add All.

2. In the Add All dialog, click OK.

   Note: When you add Ant buildfiles to your application in JDeveloper, the selected project in the Applications window is also updated and appears in the file list of the Add All dialog. Before you click OK, you may choose to ignore the update to the project .jpr file. To ignore the update, deselect the Select check box on the right of the file row.

   View Image

   

3. From the Team menu, select Git, and then select Commit All.

4. In the Commit All dialog, enter the commit comment in Comments.

   If necessary, specify your name and email address in the Author and Commiter fields in the Name <email> format.

   View Image

   

   Note: You may choose to ignore the update to the project .jpr file. To ignore the update, deselect the Select check box on the right of the file row.

5. Click OK.

6. From the Team menu, select Git, and then select Push.

   View Image

   

7. In the Welcome page of the Push to Git wizard, click Next.

8. In the Remote Repository page, click Finish.

   View Image

   

You do not need to go through all pages of the Push to Git wizard. Wait for JDeveloper to push all files to the project Git repository. After the Git Push is complete, verify the added files in the Code page.