A definição da biblioteca fornece ao hub Hubitat Elevation informações sobre a biblioteca, que podem ser adicionadas ao Código de Bibliotecas nas Ferramentas do Desenvolvedor do hub. As bibliotecas fornecem uma maneira de compartilhar código entre vários aplicativos ou drivers, definindo uma biblioteca com variáveis, métodos, etc., assim como apareceriam em app/driver:
biblioteca (
autor: "meuNome",
categoria: "amostras",
descrição: "Alguma descrição",
nome: "SampleLibrary1",
namespace: "meuNamespace",
documentaçãoLink: "http://www.example.com/"
)
//coloque métodos, etc. aqui
O nome e o namespace podem incluir apenas letras (maiúsculas ou minúsculas), números, pontos, travessões e sublinhados. Recomenda-se que o namespace seja exclusivo para você como desenvolvedor. Todas as combinações de nome e namespace devem ser exclusivas para cada biblioteca em um determinado hub. Os parâmetros name, namespace e description são os únicos parâmetros necessários no momento, embora os parâmetros adicionais possam ser usados no futuro.
Para usar uma biblioteca em um aplicativo ou driver, comece uma linha com #include seguido por um espaço, o namespace da biblioteca, um ponto final e o nome da biblioteca. Por exemplo, para incluir a biblioteca acima, escreva a seguinte linha no código do aplicativo ou driver:
#include meuNamespace.SampleLibrary1
Nenhum espaço em branco é permitido antes de
#include(deve aparecer no início da linha).
Quando o aplicativo ou driver for salvo, o código “incluído” será inserido automaticamente nos bastidores. O código incluído será anexado ao final do aplicativo ou arquivo do driver, independentemente de onde #include aparece no código original. Todos os aplicativos ou drivers que usam uma biblioteca são recompilados quando a biblioteca é alterada. Cada linha na biblioteca produz duas linhas no arquivo de código completo resultante: a primeira linha é um comentário com o número da linha na biblioteca original e a segunda é a linha de código real. (Observe que isso pode afetar o uso de recursos dentro do código da biblioteca, como strings multilinhas.)
Você pode selecionar o ícone de download (seta para baixo) próximo ao botão Importar no editor de código de aplicativos ou código de drivers para ver exatamente como o código incluído aparece no código-fonte final. O código completo pode ser útil para solucionar erros em logs que se referem a números de linha específicos, etc. Você também pode usar esse recurso para baixar uma versão completa para distribuição a outras pessoas se não quiser compartilhar o aplicativo/driver e o código da biblioteca separadamente .