Runtime Build and Publish (Reference): Commands for compiling solutions and creating deployment packages. Build validates scripts and displays, while Publish creates read-only production versions.
Access: Runtime → Build and Publish
Build Operations
Build Process
The Build feature compiles displays and scripts for final verification:
| Option | Function | When to Use |
|---|---|---|
| Build | Execute compilation | Before deployment |
| Save Backup | Create .dbbak file | Major changes |
| Rebuild All | Complete recompilation | Full validation |
| Validate Displays | Check UI components | Display changes |
Build Settings
| Setting | Options | Purpose |
|---|---|---|
| Temp Folder | Designer Settings / ProgramData | Workspace management |
| Debug Information | Include debug data | Development troubleshooting |
Temp Folder Locations:
- Designer Settings:
SolutionPath\DesignerSettings\ - ProgramData:
\ProgramData\FrameworX\
When to Build
Build is automatic during development but manual build is useful for:
| Scenario | Purpose |
|---|---|
| Many changes made | Full validation |
| Assign build number | Version tracking |
| Pack database | Optimize storage |
| Before publishing | Final verification |
Build Process Steps
- Navigate to Runtime → Build and Publish
- Select Rebuild All and Validate Displays
- Click Build
- Review build results
- Fix any errors shown
Publish Operations
Publish Process
Creates read-only .dbrun file for production:
| Setting | Function | Result |
|---|---|---|
| Publish | Create deployment file | SolutionName_Version.dbrun |
| Version | Current version number | Auto-incremented |
| Next Increment | Version strategy | Major/Minor |
Version Management
| Increment Type | Example | Use Case |
|---|---|---|
| Major | 1.0 → 2.0 | New features, breaking changes |
| Minor | 1.0 → 1.1 | Bug fixes, small updates |
Build Status
Background compilation provides continuous validation:
| Status | Indicator | Action Required |
|---|---|---|
| Green | Success | None |
| Warning | Warning | Review recommended |
| Error | Error | Fix required |
Double-click any row with issues to navigate to source.
Build vs Publish
Build Only
Suitable when:
- Continuous development expected
- Frequent field changes
- Development environment
- Testing iterations
Publish Required
Necessary for:
- Regulated industries
- Locked production systems
- Version control
- Read-only deployment
Validation Results
Warning Types
Warnings are informational:
- Won't stop execution
- May indicate potential issues
- Should be reviewed
Error Types
Errors prevent execution:
- Script won't run
- Display won't load
- Must be fixed
Best Practices Checklist
Development Phase
- Use automatic background compilation
- Fix errors as they appear
- Don't build unnecessarily
Pre-Production
- Run full build with all options
- Fix all errors
- Review warnings
- Create backup
Production Deployment
- Final build and validation
- Set version number
- Publish solution
- Archive .dbrun file
File Types
| Extension | Type | Purpose |
|---|---|---|
| .dbsln | Solution file | Development version |
| .dbbak | Backup file | Build backup |
| .dbrun | Published file | Production deployment |
Troubleshooting
| Issue | Cause | Solution |
|---|---|---|
| Build fails | Script errors | Check error list |
| Publish disabled | Build errors exist | Fix all errors first |
| Large file size | No compression | Enable database packing |
| Version conflict | Manual edit | Use version controls |
In this section...