From 6badb12f9b29f240b914f2be117564890b57037a Mon Sep 17 00:00:00 2001 From: Ryan Kurtz Date: Thu, 14 Nov 2024 08:22:19 -0500 Subject: [PATCH] GP-0: New section in GhidraDev README about installing plugin from online update site --- .../GhidraDev/GhidraDevPlugin/README.md | 42 +++++++++++++------ 1 file changed, 30 insertions(+), 12 deletions(-) diff --git a/GhidraBuild/EclipsePlugins/GhidraDev/GhidraDevPlugin/README.md b/GhidraBuild/EclipsePlugins/GhidraDev/GhidraDevPlugin/README.md index 61d489188c..72d17b45a8 100644 --- a/GhidraBuild/EclipsePlugins/GhidraDev/GhidraDevPlugin/README.md +++ b/GhidraBuild/EclipsePlugins/GhidraDev/GhidraDevPlugin/README.md @@ -137,25 +137,43 @@ __1.0.1:__ ## Installing GhidraDev can be installed either manually into Eclipse or automatically by Ghidra, depending on -your uses cases. The following two sections outline both procedures. +your uses cases. The following sections outline the different procedures. -### Manual Installation in Eclipse +### Manual Installation in Eclipse (offline) GhidraDev can be installed into an existing installation of Eclipse the same way most Eclipse -plugins are installed. From Eclipse: -1. Click `Help -> Install New Software...` -2. Click `Add...` -3. Click `Archive...` -4. Select GhidraDev zip file from `/Extensions/Eclipse/GhidraDev/` -5. Click `OK` (name field can be blank) -6. Check `Ghidra` category (or `GhidraDev` entry) -7. Click `Next` -8. Click `Next` -9. Accept the terms of the license agreement +plugins are installed. From Eclipse: + 1. Click `Help -> Install New Software...` + 2. Click `Add...` + 3. Click `Archive...` + 4. Select GhidraDev zip file from `/Extensions/Eclipse/GhidraDev/` + 5. Click `OK` (name field can be blank) + 6. Check `Ghidra` category (or `GhidraDev` entry) + 7. Click `Next` + 8. Click `Next` + 9. Accept the terms of the license agreement 10. Click `Finish` 11. Check `Unsigned` table entry 12. Click `Trust Selected` 13. Click `Restart Now` +### Manual Installation in Eclipse (online) +If you have an Internet connection, the latest GhidraDev can be installed by adding the official +[update site](https://github.com/NationalSecurityAgency/ghidra-data/raw/main/Eclipse/GhidraDev/latest) +to an existing installation of Eclipse. This has the benefit of early access to new GhidraDev +versions before the next version of Ghidra is released, and automatic updates (if you have updates +enabled in Eclipse). From Eclipse: + 1. Click `Help -> Install New Software...` + 2. Work with: `https://github.com/NationalSecurityAgency/ghidra-data/raw/main/Eclipse/GhidraDev/latest` + 3. Press `Enter` + 4. Check `Ghidra` category (or `GhidraDev` entry) + 5. Click `Next` + 6. Click `Next` + 7. Accept the terms of the license agreement + 8. Click `Finish` + 9. Check `Unsigned` table entry +10. Click `Trust Selected` +11. Click `Restart Now` + ### Automatic Installation through Ghidra Ghidra has the ability to launch an externally linked Eclipse when certain actions are performed, such as choosing to edit a Ghidra script by clicking the Eclipse icon in the Ghidra Script Manager.