Skip to content

Getting Started: Developing APNM.NET

Jump to bottom
Josiah Horton edited this page Feb 1, 2016 · 3 revisions

APNM.NET How-To

The official instruction guide for Getting the Source, Editing, Building and Using the APNM.NET plugin project. #

Getting the Source

Cloning from GitHub

Open your git shell and type git clone https://github.com/JTechMe/APNM-Framework.git

Download Zip

You can also download the zip file containing the source by clicking the Download Zip button on the GitHub page for the APNM source, or navigate to https://github.com/JTechMe/APNM-Framework/archive/master.zip

Editing the Source

Prerequisites

To edit the source code for the APNM.NET Framework you will need the following;

  • Visual Studio 12 or Higher (Visual Studio 2015 is prefered)
  • The source code for the .NET version of APNM found in the APNM.NET folder
  • Adequate knowlage of Visual Basic.NET

Setting up the Project

The project is extremely easy to set up. All you need to do is place the project files in a directory you will remember(i.e. your Projects folder in your documents) and open the .VPROJ file in Visual Studio.

Editing the Project Code

Now you're ready to start editing the project code! To start you off, lets open the AppPluginModule.vb file. The contents of this file as of version 1.0 are as follows;

Imports System.IO
Imports System.Windows.Forms
Imports System.Drawing

Public Module AppPluginModule

    Public Sub OpenSelector()
        'Dim AppSelectionForm As New Form
        Dim AppPluginSelection As New AppSelectionTree
        AppPluginSelection.Button1.PerformClick()
        'AppSelectionForm.Visible = True
        'AppSelectionTree.OpenSelectedApp()
    End Sub
End Module

#![](APNM Development scr1.png) Now we're going to add a Public Sub to the code below the OpenSelector Sub.

Public Sub MyFirstEdit()
      MessageBox.Show("This is my first edit to APNM.NET", "APNM.NET Framework", _
           MessageBoxButtons.OKCancel, MessageBoxIcon.Asterisk)
End Sub

What this will do is create a MessageBox that can be called from any project loaded with your build of the APNM.NET DLL. The code that would be used to call this MessageBox from another project would be APNM.AppPluginModule.MyFirstEdit

Changing your Version Number

Now that you've made your first edit you may want to change the build number. To do this we're going to open the Project Properties. Once the properties are open click Assembly Information. This is the information that the DLL file will be assigned to identify itself. Change the Assembly Version from 1.0.0.0 to 1.0.1.0 and the File>Save All.

Building the Source

Now that you've made an edit or two and changed the assembly version, you're ready to build the DLL! To do this we're going to Build>Rebuild Solution. After this completes navigate to the project directory \bin\debug\ and you will find three files;

  1. APNM FrameWork CL.dll
  2. APNM FrameWork CL.pdb
  3. APNM FrameWork CL.xml The important file here is the 'APNM FrameWork CL.dll'. Now you've succesfully built the APNM.Net Framework!
Copyright 2015 Josiah Horton

APNM Framework

   This Source Code Form is subject to the terms of the 
   General Open Control License, v. 1.0. If a copy of the GOC 
   was not distributed with this file, You can obtain one at 

   https://github.com/JTechMe/GOC-General-Open-Control-Licence-v1.0/

Clone this wiki locally